Exemples d'appels de l'API Budget Lines
Obtenir les options de requête de ligne budgétaire
Voici d'autres exemples d'utilisation de l'API de ligne budgétaire pour interroger et obtenir le jeu de résultats souhaité.
Cette requête renverra toutes les lignes budgétaires avec un nom de période budgétaire déjà défini
https ://<instance>.coupa.com/api/budget_lines?period[nom]=Q3 FY09
Cette requête renverra toutes les lignes budgétaires pour le propriétaire du budget avec le nom de famille de « Carlton » et que ce propriétaire fait également partie du processus d'approbation avec toutes les demandes affectant ses budgets.
https ://<instance>.coupahost.com/api/budget_lines?owner[lastname]=Carlton&owner_is_approver=true
Cette requête renverra toutes les lignes budgétaires appartenant à l'ensemble des comptes nommés, Plan comptable et où la période comptable est ouverte.
https ://<instance>.coupahost.com/api/budget_lines?period[account-type][name]=chart+of+accounts&period[is_open]=true
OBTENIR la ligne du budget
Dans cet exemple, nous avons demandé un seul enregistrement de ligne budgétaire avec un ID de
Nous avons accédé À l'URL :
https ://<instance url>/api/budget_lines/3
ou
https ://<instance url>/api/budget_lines ?id=3
Voici la réponse correspondant aux critères de recherche :
<?xml version="1.0" encoding="UTF-8"?>
<budget-line>
<id type="integer">577</id>
<created-at type="datetime">2009-05-04T18:00:58-07:00</created-at>
<updated-at type="datetime">2014-04-29T09:55:19-07:00</updated-at>
<notes />
<description>Nouvel équipement informatique acheté pour la société</description>
<amount type="decimal">128000,00</amount>
<remaining type="decimal">66883.00</remaining>
<owner-is-approver nil="true" />
<segment-1>Siège social</segment-1>
<segment-2>Développement</segment-2>
<segment-3>Actifs</segment-3>
<segment-4 nil="true" />
<segment-5 nil="true" />
<segment-6 nil="true" />
<segment-7 nil="true" />
<segment-8 nil="true" />
<segment-9 nil="true" />
<segment-10 nil="true" />
<segment-11 nil="true" />
<segment-12 nil="true" />
<segment-13 nil="true" />
<segment-14 nil="true" />
<segment-15 nil="true" />
<segment-16 nil="true" />
<segment-17 nil="true" />
<segment-18 nil="true" />
<segment-19 nil="true" />
<segment-20 nil="true" />
<error-on-overrun type="boolean">true</error-on-overrun>
<period>
<id type="integer">2</id>
<created-at type="datetime">2008-10-28T11:27:45-07:00</created-at>
<updated-at type="datetime">2011-06-07T11:24:05-07:00</updated-at>
<start-date type="datetime">2009-01-01T00:00:00-08:00:00</start-date>
<end-date type="datetime">2009-03-31T01:00:00-07:00</end-date>
<is-open type="boolean">faux</is-open>
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>Assistance</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>Soutien</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
<segment-1 type="boolean">true</segment-1>
<segment-2 type="boolean">true</segment-2>
<segment-3 type="boolean">true</segment-3>
<segment-4 nil="true" />
<segment-5 nil="true" />
<segment-6 nil="true" />
<segment-7 nil="true" />
<segment-8 nil="true" />
<segment-9 nil="true" />
<segment-10 nil="true" />
<segment-11 nil="true" />
<segment-12 nil="true" />
<segment-13 nil="true" />
<segment-14 nil="true" />
<segment-15 nil="true" />
<segment-16 nil="true" />
<segment-17 nil="true" />
<segment-18 nil="true" />
<segment-19 nil="true" />
<segment-20 nil="true" />
<name>T1 AF09</name>
<account-type>
<id type="integer">1</id>
<created-at type="datetime">27/10/2008T13:10:01-07:00</created-at>
<updated-at type="datetime">17/03/2014T14:59:59-07:00</updated-at>
<name>Ace Corporate</name>
<active type="boolean">true</active>
<currency>
<id type="integer">1</id>
<code>USD</code>
</currency>
<primary-contact>
<id type="integer">14</id>
<created-at type="datetime">27/10/2008T13:10:01-07:00</created-at>
<updated-at type="datetime">18/01/2012T11:01:36-08:00</updated-at>
<email>upgrade@coupa.com</email>
<name-prefix nil="true" />
<name-suffix nil="true" />
<name-additional nil="true" />
<name-given>Jill</name-given>
<name-family>Harker</name-family>
<name-fullname nil="true" />
<notes nil="true" />
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>Soutien</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>Assistance</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
</primary-contact>
<primary-address>
<id type="integer">17</id>
<created-at type="datetime">27/10/2008T13:10:01-07:00</created-at>
<updated-at type="datetime">18/01/2012T11:01:36-08:00</updated-at>
<name nil="true" />
<street1>28 Nevada Blvd</street1>
<street2 />
<city>Laughlin</city>
<state>NV</state>
<postal-code>94301</postal-code>
<attention nil="true" />
<active type="boolean">true</active>
<business-group-name nil="true" />
<country>
<id type="integer">223</id>
<code>États-Unis</code>
<name>États-Unis</name>
</country>
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>Assistance</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>Soutien</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
</primary-address>
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>Assistance</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">69</id>
<login>coupasupport+rohitdemo@coupa.com</login>
<email>coupasupport+rohitdemo@coupa.com</email>
<employee-number nil="true" />
<firstname>Intégration</firstname>
<lastname>Utilisateur</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
</account-type>
</period>
<owner>
<id type="integer">73</id>
<login>tri</login>
<email>trishanth.vallurupalli@coupa.com</email>
<employee-number />
<firstname>Trishanth</firstname>
<lastname>Vallurupalli</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</owner>
<currency>
<id type="integer">1</id>
<code>USD</code>
</currency>
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>Soutien</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">69</id>
<login>coupasupport+rohitdemo@coupa.com</login>
<email>coupasupport+rohitdemo@coupa.com</email>
<employee-number nil="true" />
<firstname>Intégration</firstname>
<lastname>Utilisateur</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
</budget-line>Création ligne budget
Dans cet exemple, nous créons une ligne budgétaire pour une période existante et représentons un montant de 50000. Nous n'utilisons aucun ID système Coupa pour aucun des objets de référence.
Nous l'avons posté à l'URL : https ://<instance>.coupahost.com/api/budget_lines.
<?xml version="1.0" encoding="UTF-8"?>
<budget_lines>
<segment_1>San_Francisco</segment_1>
<segment_2>Marketing</segment_2>
<segment_3>Matériel_de_bureau</segment_3>
<description>budget pour Mary</description>
<period>
<name>T2 2012</name>
</period>
<amount>50000</amount>
<owner>
<firstname>Mary (Manager)</firstname>
<lastname>Neige</lastname>
<login>msnow</login>
</owner>
</budget_lines>Mettre à jour les lignes budgétaires - mise à jour complète
Dans ces exemples, nous mettons à jour différentes informations sur l'enregistrement de la ligne budgétaire.
Nous avons fait une MISE à l'URL : https ://<instance>.coupahost.com/api/budget_lines/<budget line id>
Par exemple, pour mettre à jour le responsable budgétaire de la ligne budgétaire ID 616 :
URL : https ://<instance>.coupahost.com/api/budget_lines/616
<?xml version="1.0" encoding="UTF-8"?>
<budget_lines>
<notes>Carlton est le propriétaire du budget</notes>
<description>ceci concerne la période budgétaire T2 - 2010</description>
<owner>
<login>mcarlton</login>
</owner>
</budget_lines>Mettre à jour les lignes budgétaires - mise à jour simple
Dans ces exemples, nous mettons à jour un seul attribut sur l'enregistrement de la ligne budgétaire.
Nous avons fait une MISE à l'URL : https ://<instance url>/api/budget_lines/<budget line id>
Par exemple, pour mettre à jour le montant alloué à cette ligne budgétaire à 7500 avec la ligne budgétaire ID 616
URL : https ://<instance url>/api/budget_lines/616
<?xml version="1.0" encoding="UTF-8"?>
<budget_lines>
<amount>7500</amount>
</budget_lines>