メインコンテンツまでスキップ

 

 

Coupa Japanese

インボイスAPIの呼び出し例

このページは機械翻訳を使用して翻訳されています。


請求書のさまざまなクエリオプション

請求APIを使用してクエリを実行し、必要な結果セットを取得する方法の例を次に示します。 

このクエリはサプライヤーとしてCDWを含むすべてのインボイスを返します:

https://<instance>.coupahost.com/api/invoices?supplier[name]=CDW
 
このクエリは、通貨としてユーロを含むすべての請求書を返します。

https://<instance>.coupahost.com/api/invoices?currency[code]=EUR
 
次のクエリでは、2010年1月1日12:00:00以降に作成されたすべての請求書が返されます。

https://<instance>.coupahost.com/api/invoices?invoice-date[gt]=2010-01-01T12:00:00
 

単一請求書を取得

この例では、IDが1の単一の請求書レコードを照会しました。

URLにGETを行いました:

https://<instance>.coupahost.com/api/invoices/1
あるいは

https://<instance>.coupahost.com/api/invoices?id=1

<?xml version="1.0" encoding="UTF-8"?>
<invoice-header>
   <comments />
   <created-at type="datetime">2008-10-28T11:19:49-07:00</created-at>
   <handling-amount type="decimal">0.0</handling-amount>
   <id type="integer">1</id>
   <internal-note />
   <invoice-date type="datetime">2008-10-28T00:00:00-07:00</invoice-date>
   <invoice-number type="integer">500</invoice-number>
   <line-level-taxation type="boolean">false</line-level-taxation>
   <misc-amount type="decimal">0.0</misc-amount>
   <shipping-amount type="decimal">0.0</shipping-amount>
   <status>approved</status>
   <supplier-note />
   <tax-amount type="decimal">35.14</tax-amount>
   <tax-rate type="float">8.25</tax-rate>
   <updated-at type="datetime">2008-10-28T11:24:44-07:00</updated-at>
   <paid type="boolean">false</paid>
   <payment-date type="datetime" />
   <payment-notes />
   <exported type="boolean">false</exported>
   <invoice-description type="string" />
   <account-type>
      <id type="integer">1</id>
      <name>Ace Corporate</name>
   </account-type>
   <created-by>
      <email>upgrade+am@coupa.com</email>
      <employee-number />
      <firstname>Anna (AP Director)</firstname>
      <id type="integer">10</id>
      <lastname>Manning</lastname>
      <login>amanning</login>
   </created-by>
   <currency>
      <code>USD</code>
      <id type="integer">1</id>
   </currency>
   <supplier>
      <id type="integer">17</id>
      <name>Insight</name>
      <number nil="true" />
      <primary-contact>
         <email>upgrade@coupa.com</email>
         <id type="integer">18</id>
         <name-additional nil="true" />
         <name-family>Henderson</name-family>
         <name-fullname nil="true" />
         <name-given>Steve</name-given>
         <name-prefix nil="true" />
         <name-suffix nil="true" />
         <notes nil="true" />
         <phone-work>
            <area-code>650</area-code>
            <country-code>1</country-code>
            <extension nil="true" />
            <number>5856306</number>
         </phone-work>
         <phone-mobile>
            <area-code>650</area-code>
            <country-code>1</country-code>
            <extension nil="true" />
            <number>5856306</number>
         </phone-mobile>
         <phone-fax>
            <area-code>650</area-code>
            <country-code>1</country-code>
            <extension nil="true" />
            <number>5856306</number>
         </phone-fax>
      </primary-contact>
      <primary-address>
         <attention nil="true" />
         <city>Tempe</city>
         <id type="integer">24</id>
         <name>Insight</name>
         <postal-code>85283</postal-code>
         <state>AZ</state>
         <street1>6820 South Harl Avenue</street1>
         <street2 />
         <country>
            <code>US</code>
            <id type="integer">223</id>
            <name>United States</name>
         </country>
      </primary-address>
   </supplier>
   <tax-code>
      <code>CA</code>
      <id type="integer">1</id>
   </tax-code>
   <updated-by>
      <email>upgrade+cj@coupa.com</email>
      <employee-number />
      <firstname>Carl (Central Receiving)</firstname>
      <id type="integer">11</id>
      <lastname>Johnson</lastname>
      <login>cjohnson</login>
   </updated-by>
   <attachments />
   <invoice-lines>
      <invoice-line>
         <accounting-total type="decimal">425.99</accounting-total>
         <created-at type="datetime">2008-10-28T11:19:49-07:00</created-at>
         <description>Adobe Acrobat Professional -( v. 9 ) -complete package</description>
         <id type="integer">1</id>
         <line-num type="integer">1</line-num>
         <order-header-num type="integer">7</order-header-num>
         <order-line-id type="integer">10</order-line-id>
         <order-line-num type="integer">1</order-line-num>
         <price type="decimal">425.99</price>
         <quantity type="float">1.0</quantity>
         <status>matched</status>
         <tax-rate type="float" />
         <tax-location />
         <tax-amount type="decimal">0.00</tax-amount>
         <tax-description />
         <tax-supply-date type="datetime" />
         <total type="decimal">425.99</total>
         <type>InvoiceQuantityLine</type>
         <updated-at type="datetime">2008-10-28T11:24:44-07:00</updated-at>
         <treasury-codes type="string" />
         <account>
            <active type="boolean">true</active>
            <code>SF-IT-Assets</code>
            <id type="integer">18</id>
            <name>San Francisco -IT, Assets</name>
            <segment-1>SF</segment-1>
            <segment-10 />
            <segment-11 />
            <segment-12 />
            <segment-13 />
            <segment-14 />
            <segment-15 />
            <segment-16 />
            <segment-17 />
            <segment-18 />
            <segment-19 />
            <segment-2>IT</segment-2>
            <segment-20 />
            <segment-3>Assets</segment-3>
            <segment-4 />
            <segment-5 />
            <segment-6 />
            <segment-7 />
            <segment-8 />
            <segment-9 />
            <account-type>
               <id type="integer">1</id>
               <name>Ace Corporate</name>
            </account-type>
         </account>
         <accounting-total-currency>
            <code>USD</code>
            <id type="integer">1</id>
         </accounting-total-currency>
         <created-by>
            <email>upgrade+am@coupa.com</email>
            <employee-number />
            <firstname>Anna (AP Director)</firstname>
            <id type="integer">10</id>
            <lastname>Manning</lastname>
            <login>amanning</login>
         </created-by>
         <currency>
            <code>USD</code>
            <id type="integer">1</id>
         </currency>
         <item>
            <id type="integer">23</id>
            <created-at type="datetime">2008-10-28T10:12:02-07:00</created-at>
            <description>Adobe Acrobat 9 Professional software enables business professionals  to reliably create, combine, and control Adobe PDF documents for easy, more secure distribution, collaboration, and data collection.</description>
            <item-number>3235</item-number>
            <name>Adobe Acrobat Professional -( v. 9 ) -complete package</name>
            <updated-at type="datetime">2009-05-04T17:19:51-07:00</updated-at>
            <commodity>
               <active type="boolean">true</active>
               <created-at type="datetime">2008-10-28T17:13:45Z</created-at>
               <id type="integer">8</id>
               <name>Software</name>
               <updated-at type="datetime">2009-08-14T16:34:54Z</updated-at>
               <created-by>
                  <email>upgrade@coupa.com</email>
                  <employee-number nil="true" />
                  <firstname>Coupa</firstname>
                  <id type="integer">1</id>
                  <lastname>Support</lastname>
                  <login>coupasupport</login>
               </created-by>
               <updated-by>
                  <email>upgrade+ke@coupa.com</email>
                  <employee-number />
                  <firstname>Kyle</firstname>
                  <id type="integer">16</id>
                  <lastname>Eisner</lastname>
                  <login>administrator</login>
               </updated-by>
            </commodity>
            <support-user>
               <email>upgrade@coupa.com</email>
               <employee-number nil="true" />
               <firstname>Coupa</firstname>
               <id type="integer">1</id>
               <lastname>Support</lastname>
               <login>coupasupport</login>
            </support-user>
            <uom>
               <code>EA</code>
               <id type="integer">1</id>
            </uom>
            <support-user>
               <email>upgrade@coupa.com</email>
               <employee-number nil="true" />
               <firstname>Coupa</firstname>
               <id type="integer">1</id>
               <lastname>Support</lastname>
               <login>coupasupport</login>
            </support-user>
            <reorder-alerts />
         </item>
         <uom>
            <code>EA</code>
            <id type="integer">1</id>
         </uom>
         <updated-by>
            <email>upgrade+cj@coupa.com</email>
            <employee-number />
            <firstname>Carl (Central Receiving)</firstname>
            <id type="integer">11</id>
            <lastname>Johnson</lastname>
            <login>cjohnson</login>
         </updated-by>
      </invoice-line>
   </invoice-lines>
</invoice-header>

請求書発行の例

この例では、請求書レコードの単一の属性を更新しています。

このフィールドは請求書のカスタムフィールドである必要があります。

次のURLにPUTを実行しました: https://<instance>.coupahost.com/api/invoices/<invoice id> 

urlhttps://<instance>.coupahost.com/api/invoices/33

<?xml version="1.0" encoding="UTF-8"?>
<invoice-header>
   <invoice_description>Invoice Test Description</invoice_description>
</invoice-header>

次の例は、請求書品目を追加するためのプットコールを示しています。

<?xml version="1.0" encoding="UTF-8"?>
<invoice-header>
   <invoice-number>320</invoice-number>
   <status>draft</status>
   <invoice-lines type="array">
      <invoice-line>
         <accounting-total type="decimal">499.00</accounting-total>
         <description>iPad with Wi-Fi is ideal if you have a wireless high- speed Internet router in your home</description>
         <price type="decimal">499.00</price>
         <price-per-uom type="decimal">0.00</price-per-uom>
         <quantity type="decimal">1.0</quantity>
         <status>new</status>
         <tax-amount type="decimal">0.00</tax-amount>
         <total type="decimal">499.00</total>
         <type>InvoiceQuantityLine</type>
         <account>
            <name>HQ - IT, Assets</name>
            <code>HQ-IT-Assets</code>
            <active type="boolean">true</active>
            <segment-1>HQ</segment-1>
            <segment-2>IT</segment-2>
            <segment-3>Assets</segment-3>
            <account-type>
               <name>Ace Corporate</name>
            </account-type>
         </account>
         <account-allocations type="array" />
         <accounting-total-currency>
            <id type="integer">1</id>
            <code>USD</code>
         </accounting-total-currency>
         <currency>
            <id type="integer">1</id>
            <code>USD</code>
         </currency>
         <tax-lines type="array" />
      </invoice-line>
   </invoice-lines>
</invoice-header>
  • この記事は役に立ちましたか?