• Dernière modification le: 12 February 2020

Exemples d'appels d'API Adresses

Obtenir les options de requête d'adresse 

Voici quelques autres exemples de la façon d'utiliser l'API d'adresse pour interroger et obtenir le jeu de résultats que vous souhaitez.

Cette requête renverra toutes les adresses d'entreprise créées après la date du 1er novembre 2010.

https ://<instance url>/api/addresses ?created_at[gt]=2010-11-01T00:00:00

Cette requête renverra toutes les adresses actives et où le surnom de l'entreprise contient les mots « San Francisco ».

https ://<instance url>/api/addresses ?active=true&name[contient]=San+Francisco

Cette requête renverra toutes les adresses d'entreprise aux États-Unis et dans l'État de Californie

https ://<instance url>/api/addresses ?country[name]=États-Unis+États&états=CA

Cette requête renverra toutes les adresses personnelles où le surnom de l'adresse contient le mot « Home Office »

https ://<instance url>/api/users/85/addresses ?name=Domicile+Bureau

Obtenir l'adresse

Dans cet exemple, nous avons demandé un enregistrement d'adresse d'entreprise avec un ID de 6.

Nous avons accédé À l'URL : 

https ://<instance url>/api/adresses/6
ou
https ://<instance url>/api/adresses ?id=6

Voici la réponse correspondant aux critères de recherche :

<?xml version="1.0" encoding="UTF-8"?>

<addresses type="array">

	 <address>

			<attention />

			<city>San Francisco</city>

			<id type="integer">14</id>

			<name>Bureau de San Francisco</name>

			<postal-code>94450</postal-code>

			<state>CA</state>

			<street1>150, rue principale</street1>

			<street2 />

			<country>

				 <code>États-Unis</code>

				 <id type="integer">223</id>

				 <name>États-Unis</name>

			</country>

	 </address>

</addresses>

Dans cet exemple, nous avons demandé tous les enregistrements d'adresse personnelle pour l'utilisateur avec un ID de 85.

Nous avons accédé à l'URL :
https ://<instance url>/api/users/85/addresses

Voici la réponse correspondant aux critères de recherche :

<?xml version="1.0" encoding="UTF-8"?>

<addresses type="array">

	 <address>

			<attention>Margret Patrick</attention>

			<city>San Mateo</city>

			<id type="integer">123</id>

			<name>Bureau à domicile</name>

			<postal-code>94402</postal-code>

			<state>CA</state>

			<street1>111 rue principale</street1>

			<street2 />

			<country>

				 <code>États-Unis</code>

				 <id type="integer">223</id>

				 <name>États-Unis</name>

			</country>

	 </address>

	 <address>

			<attention>Margret Patrick</attention>

			<city>San Francisco</city>

			<id type="integer">124</id>

			<name>test2</name>

			<postal-code>94103</postal-code>

			<state>CA</state>

			<street1>2600 Polk Street</street1>

			<street2 />

			<country>

				 <code>États-Unis</code>

				 <id type="integer">223</id>

				 <name>États-Unis</name>

			</country>

	 </address>

</addresses>

Créer une adresse

Dans cet exemple, nous créons une adresse d'entreprise.

Nous l'avons posté sur l'URL  https ://<instance url>/api/adresses.

<?xml version="1.0" encoding="UTF-8"?>

<address>

	 <name>Silicon Valley</name>

	 <city>San Mateo</city>

	 <postal-code>94404</postal-code>

	 <state>CA</state>

	 <street1>2 W 5th Ave</street1>

	 <street2>Suite 300</street2>

	 <country>

			<code>États-Unis</code>

			<name>États-Unis</name>

	 </country>

</address>

Dans cet exemple, nous créons une adresse personnelle pour l'utilisateur avec l'ID utilisateur de 85.

Nous le publions à l'URL https ://<instance url>/api/users/85/addresses

<?xml version="1.0" encoding="UTF-8"?>

<address>

	 <attention nil="true" />

	 <city>San Mateo</city>

	 <id type="integer">125</id>

	 <name>Silicon Valley</name>

	 <postal-code>94400</postal-code>

	 <state>CA</state>

	 <street1>2 W 5th Ave</street1>

	 <street2 nil="true" />

	 <country>

			<code>États-Unis</code>

			<id type="integer">223</id>

			<name>États-Unis</name>

	 </country>

</address>

Créer une adresse de paiement

Dans cet exemple, nous créons une adresse de paiement pour un fournisseur spécifique

Nous l'avons posté sur l'URL https ://<instance url>/api/suppliers/<supplier id>/addresses

<?xml version="1.0" encoding="UTF-8"?>

<remit-to-address>

	 <remit-to-code>100</remit-to-code>

	 <name>100 Ellsworth</name>

	 <street1>100 Ellsworth Ave.</street1>

	 <city>SAN MATEO</city>

	 <state>CA</state>

	 <postal-code>94404</postal-code>

	 <active type="boolean">true</active>

	 <country>

			<code>États-Unis</code>

	 </country>

</remit-to-address>

Mise à jour de l'adresse

Dans ces exemples, nous mettons à jour un enregistrement d'adresse d'entreprise unique.

Nous avons fait une MISE à l'URL : https ://<instance url>/api/addresses/<address ID>

Par exemple, pour mettre à jour l'enregistrement d'adresse avec un surnom et la ligne 2 pour l'ID d'adresse 122 :

URL :  https ://<instance url>/api/addresses/122

<?xml version="1.0" encoding="UTF-8"?>

<address>

	 <name>Bureau de South Bay</name>

	 <street2>Suite 200</street2>

</address>

Par exemple, pour désactiver une adresse d'entreprise avec l'ID 122 : 

URL :  https ://<instance url>/api/addresses/122

 <?xml version="1.0" encoding="UTF-8"?>

<address>

	 <active>faux</active>

</address>

Par exemple, pour désactiver une adresse personnelle pour l'ID d'utilisateur 85 et l'ID d'adresse 125 : 

URL :  https ://<instance url>/api/users/85/addresses/125

 <?xml version="1.0" encoding="UTF-8"?>

<address>

	 <active>faux</active>

</address>

Mise à jour de l'adresse de paiement du fournisseur

Dans ces exemples, nous mettons à jour une seule adresse de paiement du fournisseur. La façon de mettre à jour l'adresse de remise, tout en étant aussi simple qu'une adresse régulière, nécessite de connaître à la fois le fournisseur et l'identifiant de remise

Nous avons fait une MISE à l'URL : https ://<instance url>/api/suppliers/<supplier id>/addresses/<remit-to address ID>

Par exemple, pour mettre à jour l'adresse de remise pour corriger le code de remise, quelle que soit la valeur actuelle, à « 001 » pour l'ID d'adresse de remise 23287 pour le fournisseur avec l'ID 12

URL :  https ://<instance url>/api/suppliers/12/remit_to_addresses/23287

<?xml version="1.0" encoding="UTF-8"?>

<remit-to-address>

	 <remit-to-code>001</remit-to-code>

</remit-to-address>

Par exemple, pour désactiver une adresse de remise avec l'ID 232887 pour le fournisseur avec l'ID 12 :

URL :  https ://<instance url>/api/suppliers/12/remit_to_addresses/23287 

<?xml version="1.0" encoding="UTF-8"?>

<remit-to-address>

	 <remit-to-code>001</remit-to-code>

	 <active>faux</active>

</remit-to-address>

 

Articles associés


API de violation des dépenses

24 April 2017

Utilisez l'API de violation de frais pour envoyer des violations de frais à votre système tiers.

API de kilométrage de la ligne de dépenses

29 November 2017

API d'allocation des lignes de frais

30 November 2017

API d'allocation de kilométrage de la ligne de dépenses

30 November 2017

Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.