AP 송장 API
벤더에서 사용하는 것과 같은 외부 시스템이 구조적이고 자동화된 방식으로 미지급금 시스템에 직접 송장을 안전하게 제출할 수 있도록 합니다.
이 API에는 외상 매입금 송장 처리sn_spend_intg 네임스페이스 내에서 제공되는 (com.sn_ap_apm) 스토어 애플리케이션이 필요합니다. 자세한 내용은 Accounts Payable Invoice Processing 문서를 참조하십시오.
- 송장, 송장 라인 및 송장 세금 라인에 대한 사용자 지정 필드를 정의합니다.
- 소스와 대상 테이블 사이에 사용자 지정 필드를 매핑합니다.
- 사용자 지정 필드를 JSON, cXML 또는 XML과 같은 특정 형식의 페이로드 항목에 매핑합니다.
- cXML을 페이로드로 사용할 때 인증을 위한 자격 증명을 설정합니다.
- 송장 첨부 파일
- XML 및 JSON 엔드포인트는 송장, 송장 라인 및 송장 케이스 수준에서 첨부 파일을 지원합니다. cXML 엔드포인트는 첨부 파일을 지원하지 않습니다.
AP 송장 - POST sn_spend_intg/ap_invoice/cxml
cXML(상거래 XML) 형식의 자동 송장을 처리합니다.
송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블을 사용하여 필드가 cXML 태그에 매핑되는 방식을 결정합니다.
추가 cXML 리소스는 https://xml.cxml.org 에서 cXML 참조 가이드를 참조하십시오.
이 API에 대한 자격 증명은 페이로드에 포함됩니다. 소스 시스템 자격 증명 [sn_spend_intg_source_system_credential] 테이블에서 자격 증명을 설정할 수 있습니다. 지침은 cXML 페이로드에서 인증을 위한 자격 증명 설정 문서를 참조하십시오.
URL 형식
버전이 지정된 URL: /api/sn_spend_intg/v1/ap_invoice/cxml
기본 URL: /api/sn_spend_intg/ap_invoice/cxml
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 경로 | 설명 |
|---|---|
| /cXML/Header/From /Credential[@domain='VendorID']/Identity | 고객이 주문할 수 있는 리셀러 또는 공급자의 식별자입니다. 대상 필드: u_supplier 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader[@invoiceDate] | 고객이 송장을 처리한 날짜입니다. 대상 필드: u_invoice_date 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 형식: YYYY-MM-DD |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader[@invoiceID] | 외부 공급업체 애플리케이션에서 생성된 송장 번호입니다. 대상 필드: u_external_invoice_number 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader[@invoiceOrigin] | 송장을 수신하는 외부 소스 시스템입니다. 예: supplier. 대상 필드: u_inbound_source 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/City | 송장이 전송되는 도시입니다. 대상 필드: u_bill_to_city 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/Country | 송장이 전송되는 국가(ISO 3166 형식)입니다. 예: US.대상 필드: u_bill_to_country 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/State | 송장이 전송되는 시 또는 도입니다. 대상 필드: u_bill_to_state_or_province 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/Street | 송장이 전송되는 도로명 주소입니다. 대상 필드: u_bill_to_street 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/PostalCode | 송장이 전송되는 우편번호입니다. 대상 필드: u_bill_to_zip_or_postal_code |
| 연락처[@role="remitTo"]/PostalAddress /Street | 지불이 이루어지는 도로명 주소입니다. 대상 필드: u_remit_address |
| 연락처[@role="remitTo"]/PostalAddress /City | 지불이 이루어지는 도시입니다. 대상 필드: u_remit_to_city |
| 연락처[@role="remitTo"]/PostalAddress/State | 지불이 이루어지는 시 또는 도입니다. 대상 필드: u_remit_to_state_or_province |
| 연락처[@role="remitTo"]/PostalAddress /PostalCode | 지불이 이루어지는 우편번호입니다. 대상 필드: u_remit_to_zip_or_postal_code |
| 연락처[@role="remitTo"]/PostalAddress/Country | 지불이 이루어지는 국가(ISO 3166 형식)입니다. 예: US.대상 필드: u_remit_to_country |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /Street | 구매 주문서의 항목이 배송된 출발지 거리입니다. 대상 필드: u_ship_from_street 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /City | 구매 주문서의 항목이 배송된 출발지 도시입니다. 대상 필드: u_ship_from_city 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /State | 구매 주문서의 항목이 배송된 출발지 주/도입니다. 대상 필드: u_ship_from_state_or_province 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /PostalCode | 구매 주문서의 항목이 배송된 출발지 우편번호입니다. 대상 필드: u_ship_from_zip_or_postal_code 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /Country | 구매 주문서의 항목이 배송된 출발지 국가입니다. 대상 필드: u_ship_from_country 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoicePartner/Contact[@role="billTo"] [@addressID] | 공급자의 법인 이름입니다. 법인 [sn_fin_legal_entity] 테이블에 있습니다. 대상 필드: u_legal_entity 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| 연락처[@role="shipTo"]/이름 | 구매 주문서의 항목이 배송될 연락처의 이름입니다. 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| 연락처[@role="shipTo"]/PostalAddress /Street | 구매 주문서의 항목이 배송된 목적지 거리입니다. 대상 필드: u_ship_to_street 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| 연락처[@role="shipTo"]/PostalAddress /City | 구매 주문서의 항목이 배송된 목적지 도시입니다. 대상 필드: u_ship_to_city 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| 연락처[@role="shipTo"]/PostalAddress/State | 구매 주문서의 항목이 배송된 목적지 시/도입니다. 대상 필드: u_ship_to_state_or_province |
| 연락처[@role="shipTo"]/PostalAddress /PostalCode | 구매 주문서의 항목이 배송된 목적지 우편번호입니다. 대상 필드: u_ship_to_zip_or_postal_code 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| 연락처[@role="shipTo"]/PostalAddress/Country | 구매 주문서의 항목이 배송된 목적지 국가입니다. 대상 필드: u_ship_from_country 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/PaymentTerm | 공급자에 대한 지불이 이루어지는 합의된 시간과 조건입니다. 예를 들어, Net 30입니다.대상 필드: u_payment_terms 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem[@description]/ | 송장 라인에 대한 설명입니다. 대상 필드: u_line_description |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem[@quantity]/ | 고객이 송장을 발행하는 상품 또는 서비스의 수량입니다. 대상 필드: u_line_quantity |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/Distribution/Accounting /AccountingSegment[1]/Name | 송장이 생성되는 비용 센터의 계정 번호입니다. 비용 센터 [cmn_cost_center] 테이블에 나열됩니다. 대상 필드: u_cost_center |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/Distribution/Accounting /AccountingSegment[2]/Name | 송장을 생성하는 데 사용되는 GL(총계정원장)의 계정 번호입니다. 대상 필드: u_gl_account |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/SubtotalAmount/Money | 세금 및 배송료를 제외하고 공급자에게 지불할 총 금액입니다. 대상 필드: u_subtotal 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/NetAmount/Money | 지정된 구매 주문 라인에 대해 고객에게 송장이 발행되는 총 비용(세금 및 배송 제외)입니다. 대상 필드: u_line_amount_invoiced 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailOrderInfo/OrderReference | 이 주문에 대해 고객이 제공한 구매 주문서 번호입니다. 구매 주문서 [sn_shop_purchase_order] 테이블에 나열됩니다. 대상 필드: u_purchase_order 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/UnitPrice/UnitOfMeasure | 송장의 항목을 계산하는 데 사용되는 UOM(기본 측정 단위)입니다. 대상 필드: u_uom 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/UnitPrice/Money | 송장 내 라인 항목의 단가입니다. 대상 필드: u_line_unit_price 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/UnitPrice/Money[@currency] | 라인 항목의 통화입니다. 예: USD대상 필드: u_currency 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem /InvoiceDetailItemReference[@lineNumber] | 참조된 공급자의 구매 주문서 라인 ID입니다. 구매 주문서 라인 [sn_shop_purchase_order_line] 테이블에 나열됩니다. 대상 필드: u_purchase_order_line 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/InvoiceDetailItemReference /ItemID/SupplierPartID | 이 송장 라인에 대해 공급자가 생성하는 파트 번호입니다. 대상 필드: u_supplier_part_number 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/InvoiceDetailItemReference /Description | 송장의 구매 주문서 라인에 대한 설명입니다. 대상 필드: u_po_line_description 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/Tax/Money | 구매에 대해 청구되는 총 세금 금액입니다. 대상 필드: u_tax_amount 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/Tax/Description | ERP 소스에서 생성된 고유 세금 코드입니다. 대상 필드: u_tax_code 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/ InvoiceDetailSummary /SubtotalAmount/돈 | 세금 및 배송료를 제외하고 공급자에게 지불할 총 금액입니다. 대상 필드: u_subtotal 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /세금/돈 | 구매에 대해 청구되는 총 세금 금액입니다. 대상 필드: u_tax_amount 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /Tax/TaxDetail[@category] | 송장에 적용할 수 있는 세금 유형입니다. 세금 유형 [sn_fin_tax_type] 테이블에 나열됩니다. 대상 필드: u_tax_type 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /tax/TaxDetail[@percentageRate] | 공급자가 부과한 세율입니다. 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] 대상 필드: u_supplier_tax_rate 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /SpecialHandlingAmount/돈 | 송장과 관련된 기타 추가 요금입니다. 편집 가능한 필드입니다. 대상 필드: u_other_charges 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /ShippingAmount/Money | 전체 구매에 대한 총 배송 비용입니다. 대상 필드: u_shipping_amount 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /GrossAmount/돈 | 필수. 소계, 세금 및 배송비에 대한 통화입니다. 소계, 세금 및 배송은 동일한 통화여야 합니다. 대상 필드: u_currency 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /InvoiceDetailDiscount/Money | 송장에 적용되는 할인입니다. 대상 필드: u_discounts 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /NetAmount/돈 | 세금 및 배송료를 포함하여 공급자에게 지불해야 할 총 금액입니다. 대상 필드: u_amount_invoiced 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. .만 지원합니다 application/xml. |
| 소스-시스템 | 요청이 들어오는 소스 시스템을 지정합니다. 사용 가능한 시스템은 소스 시스템 자격 증명 [sn_spend_intg_source_system_credential] 테이블에 나열됩니다. 이 설정은 제공된 요청이 송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블의 구조를 따르는지 확인하는 데 도움이 됩니다. 이 설정은 소스 시스템 자격 증명 [sn_spend_intg_source_system_credential] 테이블에서 자격 증명을 가져오는 데에도 사용됩니다. |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 202 | 요청이 수락되었습니다. 요청이 성공했으며 송장 처리가 진행 중입니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 429 | 요청이 너무 많습니다. 요청 속도가 시간당 최대 10개 요청을 초과했습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| batch_id | 배치 요청의 고유 식별자입니다. 이 ID는 요청 상태를 추적하는 데 사용할 수 있습니다. 이 기록은 송장 통합 로그 [sn_spend_intg_invoice_integration_log] 테이블에 저장됩니다. 데이터 유형: 문자열 |
| 오류 | 요청이 실패할 때의 오류 메시지와 세부 정보를 포함합니다.데이터 유형: 객체 |
| 오류.상세 정보 | 요청 오류에 대한 추가 상세 정보입니다. 가능한 결과:
데이터 유형: 문자열 |
| 오류.메시지 | 요청이 실패한 이유를 포함하는 오류 메시지 가능한 오류:
데이터 유형: 문자열 |
| 메시지 | 성공 메시지(예: 요청이 성공적으로 수신되어 처리 중임)입니다. 송장 통합 로그 [sn_spend_intg_invoice_integration_log] 테이블에서 요청 상태를 볼 수 있습니다. 데이터 유형: 문자열 |
| 상태 | 요청의 결과를 나타냅니다. 가능한 값:
데이터 유형: 문자열 |
cURL 요청
다음 예는 cXML 형식의 요청으로 제공된 송장을 처리하는 방법을 보여줍니다.
curl -X POST https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/cxml \
-H "Source-System: Ariba" \
-H "Content-Type: application/json" \
-d '{
"content": "------=_Part_1367_1859161670.1709186492411\r\nContent-Type: text/xml; charset=UTF-8\r\n
Content-ID: 1709186492411.10815535@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com\r\n<?xml version=\"1.0\"
encoding=\"UTF-8\"?>\r\n<!DOCTYPE cXML SYSTEM \"https://protect-us.mimecast.com/s/fgKrCERVqQU35PNzBuw39pz?domain=xml.cxml.org\">
\r\n<cXML timestamp=\"2024-02-28T22:01:32-08:00\" payloadID=\"1709186492411-3401013259654180284@10.209.37.74\">
\r\n <Response>\r\n <Status code=\"200\" text=\"OK\" />\r\n <DataResponse>\r\n <Attachment>
\r\n <URL>186492411.10815535@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.110</URL>\r\n </Attachment>
\r\n <Attachment>\r\n <URL>1709186492403.306612238@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.108</URL>
\r\n </Attachment>\r\n </DataResponse>\r\n </Response>\r\n</cXML>\r\n------=_Part_1367_1859161670.1709186492411
\r\nContent-Type: text/xml; charset=UTF-8\r\nContent-ID: 1709186492403.306612238@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.108
\r\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n
<!DOCTYPE cXML SYSTEM \"https://protect-us.mimecast.com/s/7QpfCG6VRKf15gQPwFpUTKe?domain=xml.cxml.org\">\r\n
<cXML payloadID=\"1705930173863-1790846563502652473@10.209.37.98\" timestamp=\"2024-01-22T05:29:33-08:00\" version=\"1.2.060\">\r\n
<Header>\r\n <From>\r\n <Credential domain=\"NetworkID\">\r\n <Identity>AN01532216648-T</Identity>\r\n
</Credential>\r\n <Credential domain=\"VendorID\">\r\n <Identity>3245545</Identity>\r\n
</Credential>\r\n <Credential domain=\"PrivateID\">\r\n <Identity>0000099123</Identity>\r\n
</Credential>\r\n </From>\r\n <To>\r\n <Credential domain=\"NetworkID\">\r\n
<Identity>AN01404744424-T</Identity>\r\n </Credential>\r\n <Credential domain=\"SystemID\">\r\n
<Identity>ERP1</Identity>\r\n </Credential>\r\n <Credential domain=\"EndPointID\">\r\n
<Identity>CIG</Identity>\r\n </Credential>\r\n </To>\r\n <Sender>\r\n
<Credential domain=\"NetworkID\">\r\n <Identity>AN01000000001</Identity>\r\n
<SharedSecret>Ariba@123</SharedSecret>\r\n </Credential>\r\n <UserAgent>Supplier</UserAgent>\r\n
</Sender>\r\n </Header>\r\n <Request deploymentMode=\"test\">\r\n <InvoiceDetailRequest>\r\n
<InvoiceDetailRequestHeader invoiceDate=\"2024-01-22\" invoiceID=\"\" invoiceOrigin=\"supplier\" operation=\"new\ purpose=\"PO Invoice\">\r\n
<InvoiceDetailHeaderIndicator></InvoiceDetailHeaderIndicator>\r\n
<InvoiceDetailLineIndicator></InvoiceDetailLineIndicator>\r\n <InvoicePartner>\r\n
<Contact addressID=\"Test123\" role=\"remitTo\">\r\n
<Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n
<PostalAddress>\r\n <Street>Xyz street</Street>\r\n <City>USA</City>\r\n
<State isoStateCode=\"US-NY\">NY</State>\r\n <PostalCode>10001</PostalCode>\r\n
<Country isoCountryCode=\"US\">United States</Country>\r\n </PostalAddress>\r\n
</Contact>\r\n </InvoicePartner>\r\n <InvoicePartner>\r\n
<Contact addressID=\"9009\" role=\"billTo\">\r\n <Name xml:lang=\"EN\">Bristlecone Inc</Name>\r\n
<PostalAddress>\r\n <Street>10 Boulvard-10</Street>\r\n
<City>San Jose</City>\r\n <State>CA</State>\r\n
<PostalCode>94077</PostalCode>\r\n <Country isoCountryCode=\"US\"></Country>\r\n
</PostalAddress>\r\n <Phone>\r\n <TelephoneNumber>\r\n
<CountryCode isoCountryCode=\"US\">1</CountryCode>\r\n <Number>7687687799</Number>\r\n
</TelephoneNumber>\r\n </Phone>\r\n <Fax>\r\n
<TelephoneNumber>\r\n <CountryCode isoCountryCode=\"US\">1</CountryCode>\r\n
<Number>768-FAX-NUMBER</Number>\r\n </TelephoneNumber>\r\n </Fax>\r\n
</Contact>\r\n </InvoicePartner>\r\n <InvoicePartner>\r\n <Contact role=\"from\">\r\n
<Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n <PostalAddress>\r\n
<Street>123 , street no 5</Street>\r\n <City>Dallas</City>\r\n
<State isoStateCode=\"US-AL\">AL</State>\r\n <PostalCode>36615</PostalCode>\r\n
<Country isoCountryCode=\"US\">United States</Country>\r\n </PostalAddress>\r\n
</Contact>\r\n </InvoicePartner>\r\n <InvoiceDetailShipping>\r\n
<Contact role=\"shipFrom\">\r\n <Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n
<PostalAddress>\r\n <Street>Deendayal Urja Bhawan</Street>\r\n
<City>New Delhi</City>\r\n <State isoStateCode=\"IN-MH\">Maharashtra</State>\r\n
<PostalCode>110070</PostalCode>\r\n <Country isoCountryCode=\"IN\">India</Country>\r\n
</PostalAddress>\r\n </Contact>\r\n <Contact addressID=\"9999\" role=\"shipTo\">\r\n
<Name xml:lang=\"EN\">Buyer Plant Bristlecone</Name>\r\n <PostalAddress name=\"default\">\r\n
<Street>18 Hanoi Road</Street>\r\n <City>San Jose</City>\r\n
<State>CA</State>\r\n <PostalCode>77077</PostalCode>\r\n
<Country isoCountryCode=\"US\"></Country>\r\n </PostalAddress>\r\n
<Email name=\"default\" preferredLang=\"en\">test@test.com</Email>\r\n </Contact>\r\n
</InvoiceDetailShipping>\r\n </InvoiceDetailRequestHeader>\r\n <InvoiceDetailOrder>\r\n
<InvoiceDetailOrderInfo>\r\n <OrderReference orderID=\"\">\r\n
<DocumentReference payloadID=\"0AAF8EA1FA5F1EDE9FDC97460BCB03E1\"></DocumentReference>\r\n
</OrderReference>\r\n </InvoiceDetailOrderInfo>\r\n
<InvoiceDetailItem invoiceLineNumber=\"2\" quantity=\"25\" description=\"Indian Oil\">\r\n
<UnitOfMeasure>EA</UnitOfMeasure>\r\n <UnitPrice>\r\n <Money currency=\"USD\">50</Money>\r\n
</UnitPrice>\r\n <SubtotalAmount>\r\n <Money currency=\"USD\">1250.00</Money>\r\n
</SubtotalAmount>\r\n </InvoiceDetailItem>\r\n </InvoiceDetailOrder>\r\n </InvoiceDetailRequest>\r\n
</Request>\r\n</cXML>\r\n------=_Part_1367_1859161670.1709186492411--"
}'
다음 결과는 요청이 성공했으며 송장 데이터가 처리 중임을 보여줍니다. 송장 통합 로그 [sn_spend_intg_invoice_integration_log] 테이블에서 요청 상태를 볼 수 있습니다. 배치 ID 열에 나열된 배치 ID를 사용하여 송장을 찾습니다.
{
"batchId": "APIINV1729711710733280",
"status": "Success",
"message": "Your request has been successfully received and is being processed."
}
AP 송장 - POST sn_spend_intg/ap_invoice/json
JSON 형식으로 자동 송장을 처리합니다.
필요한 역할: sn_spend_intg.procurement_integrator
송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블을 사용하여 필드가 JSON 속성에 매핑되는 방식을 결정합니다.
URL 형식
버전이 지정된 URL: /api/sn_spend_intg/v1/ap_invoice/json
기본 URL: /api/sn_spend_intg/ap_invoice/json
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| 송장 | 처리할 각 송장이 포함된 목록입니다. 데이터 유형: 중첩된 송장 객체의 객체입니다. |
| invoices.amount_invoiced | 세금 및 배송료를 포함하여 공급자에게 지불해야 할 총 금액입니다. 대상 필드: u_amount_invoiced 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| bill_to_city | 송장이 전송되는 도시입니다. 대상 필드: u_bill_to_city 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| bill_to_country | 송장이 전송되는 국가(ISO 3166 형식)입니다. 예: US.대상 필드: u_bill_to_country 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| bill_to_state_or_province | 송장이 전송되는 시 또는 도입니다. 대상 필드: u_bill_to_state_or_province 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| bill_to_street | 송장이 전송되는 도로명 주소입니다. 대상 필드: u_bill_to_street 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| bill_to_zip_or_postal_code | 송장이 전송되는 우편번호입니다. 대상 필드: u_bill_to_zip_or_postal_code |
| invoices.business_owner | 비즈니스 측에서 애플리케이션을 소유한 소유자의 이름입니다. 대상 필드: u_business_owner 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.currency | 필수. 소계, 세금 및 배송비에 대한 통화입니다. 소계, 세금 및 배송은 동일한 통화여야 합니다. 대상 필드: u_currency 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| 송장.할인 | 송장에 적용되는 할인입니다. 대상 필드: u_discounts 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.erp_number | 구매 주문에 대해 ERP(전사적 자원 관리) 시스템 내에서 생성된 고유 번호입니다. 자세한 내용은 Purchase order integration 문서를 참조하십시오. 대상 필드: u_erp_number 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| 송장. external_invoice_number | 필수 외부 공급업체 애플리케이션에서 생성된 송장 번호입니다. 대상 필드: u_external_invoice_number 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| 송장. invoice_copy_attachment | 송장 수준에서 정의된 첨부 파일 목록입니다. Accounts Payable Invoice Processing 문서를 참조하십시오. 생성되면 시스템은 연결된 송장 케이스 및 송장 라인과 함께 송장 기록을 생성합니다. 첨부 파일은 그에 따라 해당 기록에 연결됩니다. 데이터 유형: 객체 배열 |
| invoices.invoice_copy_attachment. 콘텐츠 | 첨부 파일의 Base64 인코딩 파일 콘텐츠입니다. 데이터 유형: 문자열 |
| invoices.invoice_copy_attachment. 인코딩 | 이 값은 항상 base64입니다. 데이터 유형: 문자열 |
| invoices.invoice_copy_attachment. mime_code | 이 값은 항상 base64입니다. 데이터 유형: 문자열 |
| invoices.invoice_copy_attachment. 이름 | 첨부 파일의 파일 이름입니다. 주: 첨부 파일 이름에 예약된 "SD_" 접두사를 사용하지 마십시오. 데이터 유형: 문자열 |
| invoices.invoice_date | 필수 고객이 송장을 처리한 날짜입니다. 대상 필드: u_invoice_date 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 형식: YYYY-MM-DD |
| invoices.invoice_line_count | 송장의 라인 수입니다. 대상 필드: u_invoice_line_count 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines | 이 주문 내의 구매에 대해 송장 처리되는 라인을 정의하는 객체 목록입니다. 송장 라인은 송장 라인 임포트 인바운드[sn_spend_intg_imp_invoice_line] 테이블에서 준비됩니다. 데이터 유형: 객체 배열 |
| invoices.invoice_lines. 첨부 파일 | 송장 라인 수준에서 정의된 첨부 파일 목록입니다. Create New Invoice Line form 문서를 참조하십시오. 생성되면 시스템은 연결된 송장 케이스 및 송장 라인과 함께 송장 기록을 생성합니다. 첨부 파일은 그에 따라 해당 기록에 연결됩니다. 데이터 유형: 객체 배열 |
| invoices.invoice_lines. 첨부 파일.컨텐츠 | 첨부 파일의 Base64 인코딩 파일 콘텐츠입니다. 데이터 유형: 문자열 |
| invoices.invoice_lines. 첨부 파일.인코딩 | 이 값은 항상 base64입니다. 데이터 유형: 문자열 |
| invoices.invoice_lines. attachments.mime_code | 이 값은 항상 base64입니다. 데이터 유형: 문자열 |
| invoices.invoice_lines. attachments.name | 첨부 파일의 파일 이름입니다. 주: 첨부 파일 이름에 예약된 "SD_" 접두사를 사용하지 마십시오. 데이터 유형: 문자열 |
| invoices.invoice_lines. cost_center | 송장이 생성되는 비용 센터의 계정 번호입니다. 비용 센터 [cmn_cost_center] 테이블에 나열됩니다. 대상 필드: u_cost_center 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. 통화 | 라인 항목의 통화입니다. 예: USD대상 필드: u_currency 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. external_invoice_number | 필수 외부 공급업체 애플리케이션에서 생성된 송장 번호입니다. 대상 필드: u_external_invoice_number 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. gl_account | 송장을 생성하는 데 사용되는 GL(총계정원장)의 계정 번호입니다. 대상 필드: u_gl_account 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. line_amount_invoiced | 필수 지정된 구매 주문 라인에 대해 고객에게 송장이 발행되는 총 비용(세금 및 배송 제외)입니다. 대상 필드: u_line_amount_invoiced 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. line_description | 필수 송장 라인에 대한 설명입니다. 대상 필드: u_line_description 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. line_quantity | 필수 고객이 송장을 발행하는 상품 또는 서비스의 수량입니다. 대상 필드: u_line_quantity 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. line_unit_price | 송장 내 라인 항목의 단가입니다. 대상 필드: u_line_unit_price 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. po_line_description | 송장의 구매 주문서 라인에 대한 설명입니다. 대상 필드: u_po_line_description 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. purchase_order_line | 필수 참조된 공급자의 구매 주문서 라인 ID입니다. 구매 주문서 라인 [sn_shop_purchase_order_line] 테이블에 나열됩니다. 대상 필드: u_purchase_order_line 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. ship_to_city | 구매 주문서의 항목이 배송된 목적지 도시입니다. 대상 필드: u_ship_to_city 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. ship_to_country | 구매 주문서의 항목이 배송된 목적지 국가입니다. 대상 필드: u_ship_to_country 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. ship_to_state_or_province | 구매 주문서의 항목이 배송된 목적지 시/도입니다. 대상 필드: u_ship_to_state_or_province 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. ship_to_street | 구매 주문서의 항목이 배송된 목적지 거리입니다. 대상 필드: u_ship_to_street 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. ship_to_zip_or_postal_code | 구매 주문서의 항목이 배송된 목적지 우편번호입니다. 대상 필드: u_ship_to_zip_or_postal_code 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. 소계 | 필수 세금 및 배송료를 제외하고 공급자에게 지불할 총 금액입니다. 대상 필드: u_subtotal 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. supplier_part_number | 필수 이 송장 라인에 대해 공급자가 생성하는 파트 번호입니다. 대상 필드: u_supplier_part_number 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. tax_code | ERP 소스에서 생성된 고유 세금 코드입니다. 대상 필드: u_tax_code 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. tax_details | 송장 라인과 연결된 구매에 대한 세금 라인 목록입니다. 데이터 유형: 객체 배열 |
| invoices.invoice_lines. tax_details.tax_amount | 필수 구매에 대해 청구되는 총 세금 금액입니다. 대상 필드: u_tax_amount 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.invoice_lines. tax_details.tax_rate | 공급자가 부과한 세율입니다. 대상 필드: u_supplier_tax_rate 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines. tax_details.세금 유형 | 송장에 적용할 수 있는 세금 유형입니다. 세금 유형 [sn_fin_tax_type] 테이블에 나열됩니다. 대상 필드: u_tax_type 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_lines.uom | 송장의 항목을 계산하는 데 사용되는 UOM(기본 측정 단위)입니다. 대상 필드: u_uom 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.invoice_type | 처리할 송장의 유형입니다. 대상 필드: u_invoice_type 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.legal_entity | 공급자의 법인 이름입니다. 법인 [sn_fin_legal_entity] 테이블에 있습니다. 대상 필드: u_legal_entity 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.original_invoice | 공급자가 생성한 고유 송장 번호입니다. 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 대상 필드: u_original_invoice 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.other_charges | 송장과 관련된 기타 추가 요금입니다. 편집 가능한 필드입니다. 대상 필드: u_other_charges 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.payment_terms | 공급자에 대한 지불이 이루어지는 합의된 시간과 조건입니다. 예를 들어, Net 30입니다.관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.purchase_order | 필수 이 주문에 대해 고객이 제공한 구매 주문서 번호입니다. 구매 주문서 [sn_shop_purchase_order] 테이블에 나열됩니다. 대상 필드: u_purchase_order 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| invoices.remit_address | 필수 지불이 이루어지는 도로명 주소입니다. 대상 필드: u_remit_address 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.remit_to_city | 필수 지불이 이루어지는 도시입니다. 대상 필드: u_remit_to_city 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.remit_to_country | 필수 지불이 이루어지는 국가(ISO 3166 형식)입니다. 예: US.대상 필드: u_remit_to_country 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| 송장. remit_to_state_or_province | 필수 지불이 이루어지는 시 또는 도입니다. 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| 송장. remit_to_zip_or_postal_code | 필수 지불이 이루어지는 우편번호입니다. 대상 필드: u_remit_to_state_or_province 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.ship_from_city | 구매 주문서의 항목이 배송된 출발지 도시입니다. 대상 필드: u_ship_from_city 데이터 유형: 문자열 최대 길이: 100 |
| invoices.ship_from_country | 구매 주문서의 항목이 배송된 출발지 국가입니다. 대상 필드: u_ship_from_country 데이터 유형: 문자열 최대 길이: 100 |
| 송장. ship_from_state_or_province | 구매 주문서의 항목이 배송된 출발지 주/도입니다. 대상 필드: u_ship_from_state_or_province 데이터 유형: 문자열 최대 길이: 100 |
| invoices.ship_from_street | 구매 주문서의 항목이 배송된 출발지 거리입니다. 대상 필드: u_ship_from_street 데이터 유형: 문자열 최대 길이: 100 |
| 송장. ship_from_zip_or_postal_code | 구매 주문서의 항목이 배송된 출발지 우편번호입니다. 대상 필드: u_ship_from_zip_or_postal_code 데이터 유형: 문자열 최대 길이: 100 |
| invoices.ship_to_city | 구매 주문서의 항목이 배송된 목적지 도시입니다. 대상 필드: u_ship_to_city 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.ship_to_country | 구매 주문서의 항목이 배송된 목적지 국가입니다. 대상 필드: u_ship_to_country 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| 송장. ship_to_state_or_province | 구매 주문서의 항목이 배송된 목적지 시/도입니다. 대상 필드: u_ship_to_state_or_province 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.ship_to_street | 구매 주문서의 항목이 배송된 목적지 거리입니다. 대상 필드: u_ship_to_street 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| 송장. ship_to_zip_or_postal_code | 구매 주문서의 항목이 배송된 목적지 우편번호입니다. 대상 필드: u_ship_to_zip_or_postal_code 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.shipping_amount | 필수 전체 구매에 대한 총 배송 비용입니다. 대상 필드: u_shipping_amount 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| 송장.소계 | 필수 세금 및 배송료를 제외하고 공급자에게 지불할 총 금액입니다. 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 40 |
| 송장.공급자 | 필수 고객이 주문할 수 있는 리셀러 또는 공급자의 식별자입니다. 대상 필드: u_supplier 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| 송장. supplier_invoice_number | 필수 이 송장에 대해 공급자가 생성한 식별 번호입니다. 대상 필드: u_supplier_invoice_number 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.supplier_tax_id | 외부 공급업체 리셀러와 연결된 세금 식별자입니다. 편집 가능한 필드입니다. 대상 필드: u_supplier_tax_id 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 데이터 유형: 문자열 최대 길이: 100 |
| invoices.target_erp | 송장이 게시된 ERP 기록입니다. ERP 소스 [sn_fin_erp_source] 테이블에 있습니다. ERP source 문서를 참조하십시오. 데이터 유형: 문자열 |
| 송장. supporting_attachments | 외상 매입금 전문가에게 할당된 케이스에 대해 송장 처리 케이스 수준에서 정의된 첨부 파일 목록입니다. Invoice processing case form 문서를 참조하십시오. 생성되면 시스템은 연결된 송장 케이스 및 송장 라인과 함께 송장 기록을 생성합니다. 첨부 파일은 그에 따라 해당 기록에 연결됩니다. 데이터 유형: 객체 배열 |
| 송장. supporting_attachments.content | 첨부 파일의 Base64 인코딩 파일 콘텐츠입니다. 데이터 유형: 문자열 |
| 송장. supporting_attachments.encoding | 이 값은 항상 base64입니다. 데이터 유형: 문자열 |
| 송장. supporting_attachments.mime_code | 이 값은 항상 base64입니다. 데이터 유형: 문자열 |
| 송장. supporting_attachments.name | 첨부 파일의 파일 이름입니다. 주: 첨부 파일 이름에 예약된 "SD_" 접두사를 사용하지 마십시오. 데이터 유형: 문자열 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. .만 지원합니다 application/json. |
| 소스-시스템 | 요청이 들어오는 소스 시스템을 지정합니다. 이 설정은 제공된 요청이 송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블의 구조를 따르는지 확인하는 데 도움이 됩니다. |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 202 | 요청이 수락되었습니다. 요청이 성공했으며 송장 처리가 진행 중입니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 429 | 요청이 너무 많습니다. 요청 속도가 시간당 최대 10개 요청을 초과했습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| batch_id | 배치 요청의 고유 식별자입니다. 이 ID는 요청 상태를 추적하는 데 사용할 수 있습니다. 이 기록은 송장 통합 로그 [sn_spend_intg_invoice_integration_log] 테이블에 저장됩니다. 데이터 유형: 문자열 |
| 오류 | 요청이 실패할 때의 오류 메시지와 세부 정보를 포함합니다.데이터 유형: 객체 |
| 오류.상세 정보 | 요청 오류에 대한 추가 상세 정보입니다. 가능한 결과:
데이터 유형: 문자열 |
| 오류.메시지 | 요청이 실패한 이유를 포함하는 오류 메시지 가능한 오류:
데이터 유형: 문자열 |
| 메시지 | 성공 메시지(예: 요청이 성공적으로 수신되어 처리 중임)입니다. 송장 통합 로그 [sn_spend_intg_invoice_integration_log] 테이블에서 요청 상태를 볼 수 있습니다. 데이터 유형: 문자열 |
| 상태 | 요청의 결과를 나타냅니다. 가능한 값:
데이터 유형: 문자열 |
cURL 요청
다음 예는 JSON 형식으로 요청으로 제공된 송장을 처리하는 방법을 보여줍니다. Base64 인코딩은 크기가 다양하며 매우 클 수 있습니다. 공간 절약을 위해 컨텐츠 값이 잘렸습니다. 정보는 적절한 페이로드 구조를 반영합니다.
curl "https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/json" \
--request \
POST \
--header \
"Source-System: Coupa" \
--header \
"Content-Type: application/json" \
--user 'username' \
:'password' \
--data \
'{
"invoices": [
{
"invoice_type": "",
"supplier_invoice_number": "2InvoiceAttach_A1",
"external_invoice_number": "EXT-INV-erp-po-1_Attach1",
"supplier": "",
"business_owner": "lara.croft@example.com",
"purchase_order": "",
"date_format": "DD MMMM, YYYY",
"invoice_date": "2nd June, 2021",
"payment_terms": "Net 30",
"legal_entity": "AUS",
"subtotal": "(100.00)",
"shipping_amount": "30.00",
"other_charges": "20.00",
"discounts": "00.00",
"amount_invoiced": "200.00",
"currency": "USD",
"invoice_line_count": "10",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"ship_from_city": "Los Angeles",
"ship_from_country": "USA",
"ship_from_state_or_province": "CA",
"ship_from_street": "456 Oak Ave",
"ship_from_zip_or_postal_code": "90001",
"remit_address": "789 Elm St, Suite 200",
"remit_to_city": "Chicago",
"remit_to_country": "USA",
"remit_to_state_or_province": "IL",
"remit_to_zip_or_postal_code": "60601",
"supplier_tax_id": "123456789",
"invoice_copy_attachment": [
{
"file_name": "InvoiceTestInv_Json_A1.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmV/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "InvoiceTestINVIMG_Json_A1.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1B/Base64EncodingIntentionallyTruncated"
}
],
"tax_details": [
{
"tax_type": "CGST",
"tax_amount": "10",
"tax_rate": ""
},
{
"tax_type": "Withholding tax",
"tax_amount": "",
"tax_rate": "25"
},
{
"tax_type": "Sales tax",
"tax_amount": "12",
"tax_rate": "12"
}
],
"invoice_lines": [
{
"external_invoice_number": "EXT-INV-erp-po-1",
"line_description": "2INV_Line_Attach_A1",
"po_line_description": "",
"purchase_order_line": "",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00",
"line_amount_invoiced": "118.00",
"currency": "USD",
"cost_center": "ACN00001",
"gl_account": "100001",
"tax_code": "A1 - Sales tax, reduced rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"attachments": [
{
"file_name": "InvoiceTestLine.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQc/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "InvoiceTest1Line.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ0MgUHJvZmW2GWCy8SpAszALlJ/Mv6HK54/f/3/XFv4ysU57JMAAAAASUVORK5CYII="
}
]
},
{
"external_invoice_number": "EXT-INV-erp-po-3",
"line_description": "Testing",
"po_line_description": "",
"purchase_order_line": "",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00",
"line_amount_invoiced": "118.00",
"currency": "USD",
"cost_center": "ACN00005",
"gl_account": "100002",
"tax_code": "A1 - Sales tax, reduced rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours"
}
]
},
{
"invoice_type": "",
"supplier_invoice_number": "10MultiInvoiceAttach_A2",
"external_invoice_number": "EXT-INV-noerp-PO_Attach_A2",
"purchase_order": "0004531004",
"supplier": "880733",
"date_format": "DD-MM-YYYY",
"invoice_date": "02-05-2021",
"payment_terms": "NET 30",
"legal_entity": "XYZ Ltd.",
"subtotal": "100",
"shipping_amount": "30.00",
"other_charges": "20.00",
"discounts": "10.00",
"amount_invoiced": "140.00",
"currency": "USD",
"invoice_line_count": "1",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"ship_from_city": "Los Angeles",
"ship_from_country": "USA",
"ship_from_state_or_province": "CA",
"ship_from_street": "456 Oak Ave",
"ship_from_zip_or_postal_code": "90001",
"remit_address": "789 Elm St, Suite 200",
"remit_to_city": "Chicago",
"remit_to_country": "USA",
"remit_to_state_or_province": "IL",
"remit_to_zip_or_postal_code": "60601",
"supplier_tax_id": "12340009",
"supporting_attachments": [
{
"file_name": "10InvcCaseTstInv_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50YXRpb24gOTY3MTUxMzkw/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstPNGInv_Json_A2.png",
"mime_code": "image/png",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ0MgUHJvZmlsZQAASImVVwdY/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstInv2_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50YXRpb24gOTY3MTQzNjgzKQovQXV0aG9yIChQYWdlcm8gQUIpCi9Td/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstXMLINV_Json_A2.xml",
"mime_code": "text/xml",
"encoding": "base64",
"content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9I/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTtExcelINV_Json_A2.xlsx",
"mime_code": "application/vnd.ms-excel",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAAAAAAAAAAAAAA/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstCSVINV_Json_A2.csv",
"mime_code": "text/csv",
"encoding": "base64",
"content": "Im51bWJlciIsInN1cHBsaWVyX2ludm9pY2VfbnVtYmVyIiwic3VwcGxpZXIiLCJzdGF0ZSIsInR5cGUiLCJkd/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstJsonINV_Json_A2.json",
"mime_code": "application/json",
"encoding": "base64",
"content": "eyJyZWNvcmRzIjpbeyJyZXF1aXJlc19hY2tub3dsZWRnZW1lbnQiOiJmYWxzZSIsInRheF9hbW91buYm91bmRfc291cmNlIjoiIn1dfQ==/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstdocINV_Json_A2.docx",
"mime_code": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAAAAAAAAAAA/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceCasePPT_Json_A2.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiB="
},
{
"file_name": "10InvoiceCaseRichText_Json_A2.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYXRleHRzY2FsaW5nMFxjb2NvYXBsYXRmb3JtM/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTst_INVJPG_Json_A2.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINCgoNEhQQEBIQEB/Base64EncodingIntentionallyTruncated"
}
],
"invoice_copy_attachment": [
{
"file_name": "10InvoiceTestInv_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50YXRpb24g/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestInv_Json_A2.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ0MgUHJvZmls/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvceTstInv2_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50YXRpb24g=/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestXMLINV_Json_A2.xml",
"mime_code": "text/xml",
"encoding": "base64",
"content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vI/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestExcelINV_Json_A2.xlsx",
"mime_code": "application/vnd.ms-excel",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAAAAAAAAAAAAAA=/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestCSVINV_Json_A2.csv",
"mime_code": "text/csv",
"encoding": "base64",
"content": "Im51bWJlciIsInN1cHBsaWVyX2ludm9pY2VfbnVtYmVyIiwic3VwcGxpZXIiLCJzd/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestJsonINV_Json_A2.json",
"mime_code": "application/json",
"encoding": "base64",
"content": "eyJyZWNvcmRzIjpbeyJyZXF1aXJlc19hY2tub3dsZWRnZW1lbnQiOiJmYWxzZSI/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestdocINV_Json_A2.docx",
"mime_code": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnht/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoicePPT_Json_A2.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtb/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceRichText_Json_A2.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYXRleHRz/Base64EncodingIntentionallyTruncated"
}
],
"tax_details": [
{
"tax_type": "Value added tax",
"tax_amount": "21",
"tax_rate": ""
},
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "22"
},
{
"tax_type": "Withholding tax",
"tax_amount": "23",
"tax_rate": ""
}
],
"invoice_lines": [
{
"external_invoice_number": "EXT-INV-noerp-PO_Attach_A2",
"purchase_order_line": "00045310041",
"po_line_description": "Yeti microphone - black",
"line_description": "10MultiInvoiceLineAttach_A2",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00-",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00001",
"gl_account": "141150",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"attachments": [
{
"file_name": "10InvoiceTest_INVLine_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTest_INVLine_Json_A2.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ0Mg/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvceTst2_INVLine_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50Y/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestXML_INVLine_Json_A2.xml",
"mime_code": "text/xml",
"encoding": "base64",
"content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxv/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestExcel_INVLine_Json_A2.xlsx",
"mime_code": "application/vnd.ms-excel",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZX/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestdoc_INVLine_Json_A2.docx",
"mime_code": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZX/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10_InvoiceLinePPT_Json_A2.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZX/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10_InvoiceLineRichText_Json_A2.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYX/Base64EncodingIntentionallyTruncated"
}
],
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "3.4"
},
{
"tax_type": "GST",
"tax_amount": "3.9",
"tax_rate": ""
},
{
"tax_type": "VAT",
"tax_amount": "2",
"tax_rate": "4"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO",
"purchase_order_line": "00045310041",
"po_line_description": "Yeti microphone - black",
"line_description": "Testing ERP POL",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00-",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00001",
"gl_account": "141150",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "3.4"
},
{
"tax_type": "GST",
"tax_amount": "3.9",
"tax_rate": ""
},
{
"tax_type": "VAT",
"tax_amount": "2",
"tax_rate": "4"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO_Attach3",
"purchase_order_line": "00045310042",
"po_line_description": "Pv-3310 photo tripod w/3-way pan",
"line_description": "Date Formate Test",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "100.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00002",
"gl_account": "100005",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "3.2"
},
{
"tax_type": "Withholding tax",
"tax_amount": "",
"tax_rate": "4"
},
{
"tax_type": "VAT",
"tax_amount": "",
"tax_rate": "3"
}
],
"attachments": [
{
"file_name": "InvoiceLinePPT.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXN/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "InvoiceLineRichText.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYX/Base64EncodingIntentionallyTruncated"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO-01",
"purchase_order_line": "00045310042",
"po_line_description": "Yeti microphone - black",
"line_description": "",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "100.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00005",
"gl_account": "141101",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "SGST",
"tax_amount": "",
"tax_rate": "3.1"
},
{
"tax_type": "GST",
"tax_amount": "3.8",
"tax_rate": ""
},
{
"tax_type": "CGST",
"tax_amount": "",
"tax_rate": "1.2"
}
]
}
]
},
{
"invoice_type": "",
"supplier_invoice_number": "LineLevelTax_Attach3",
"external_invoice_number": "EXT-INV-noerp-PO-line_attach3",
"purchase_order": "",
"supplier": "880733",
"date_format": "mm-dd-yyyy",
"invoice_date": "09-05-2021",
"payment_terms": "NET 30",
"legal_entity": "1100.",
"subtotal": "100",
"shipping_amount": "30.00",
"other_charges": "20.00",
"discounts": "10.00-",
"amount_invoiced": "140.00",
"currency": "USD",
"invoice_line_count": "1",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"ship_from_city": "Los Angeles",
"ship_from_country": "USA",
"ship_from_state_or_province": "CA",
"ship_from_street": "456 Oak Ave",
"ship_from_zip_or_postal_code": "90001",
"remit_address": "789 Elm St, Suite 200",
"remit_to_city": "Chicago",
"remit_to_country": "USA",
"remit_to_state_or_province": "IL",
"remit_to_zip_or_postal_code": "60601",
"supplier_tax_id": "12340009",
"invoice_copy_attachment": [
{
"file_name": "InvoicePPT.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXNdLnh/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "InvoiceRichText.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYXRleH/Base64EncodingIntentionallyTruncated"
}
],
"invoice_lines": [
{
"external_invoice_number": "EXT-INV-noerp-PO-3",
"purchase_order_line": "00045310041",
"po_line_description": "Yeti microphone - black",
"line_description": "Testing ERP POL",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00005",
"gl_account": "120040",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "6"
},
{
"tax_type": "GST",
"tax_amount": "7",
"tax_rate": ""
},
{
"tax_type": "Sales tax",
"tax_amount": "8",
"tax_rate": "8"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO-3",
"purchase_order_line": "00045310042",
"po_line_description": "Pv-3310 photo tripod w/3-way pan",
"line_description": "Date Formate Test",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00001",
"gl_account": "141250",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "CGST",
"tax_amount": "",
"tax_rate": "4.1"
},
{
"tax_type": "SGST",
"tax_amount": "4.4",
"tax_rate": ""
},
{
"tax_type": "VAT",
"tax_amount": "",
"tax_rate": "4.3"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO-3",
"purchase_order_line": "00045310042",
"po_line_description": "Yeti microphone - black",
"line_description": "",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "100.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00007",
"gl_account": "141300",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "2.4"
},
{
"tax_type": "Withholding tax",
"tax_amount": "5.5",
"tax_rate": ""
},
{
"tax_type": "VAT",
"tax_amount": "2.6",
"tax_rate": ""
}
]
}
]
},
{
"invoice_type": "credit_memo",
"supplier_invoice_number": "EXT-INV-erp-po_AttachLine",
"external_invoice_number": "EXT-INV-erp-po_AttachLine",
"original_invoice": "INV0001013",
"supplier": "",
"business_owner": "lara.croft@example.com",
"purchase_order": "0004889699",
"invoice_date": "09/13/2024",
"payment_terms": "Net 30",
"legal_entity": "AUS",
"subtotal": "150.00",
"shipping_amount": "30.00",
"other_charges": "20.00",
"discounts": "00.00",
"amount_invoiced": "200.00",
"currency": "USD",
"invoice_line_count": "10",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"ship_from_city": "Los Angeles",
"ship_from_country": "USA",
"ship_from_state_or_province": "CA",
"ship_from_street": "456 Oak Ave",
"ship_from_zip_or_postal_code": "90001",
"remit_address": "789 Elm St, Suite 200",
"remit_to_city": "Chicago",
"remit_to_country": "USA",
"remit_to_state_or_province": "IL",
"remit_to_zip_or_postal_code": "60601",
"supplier_tax_id": "123456789",
"tax_details": [
{
"tax_type": "CGST",
"tax_amount": "15",
"tax_rate": ""
},
{
"tax_type": "Sales tax",
"tax_amount": "",
"tax_rate": "10"
},
{
"tax_type": "SGST",
"tax_amount": "10",
"tax_rate": ""
}
],
"invoice_lines": [
{
"external_invoice_number": "EXT-INV-erp-po_AttachLine",
"line_description": "POL ERP number Attachment on line only",
"po_line_description": "",
"purchase_order_line": "00048896991",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "100.00",
"line_amount_invoiced": "118.00",
"currency": "USD",
"cost_center": "ACN00004",
"gl_account": "436000",
"tax_code": "A1 - Sales tax, reduced rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"attachments": [
{
"file_name": "InvoiceLinePPT.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXN/Base64EncodingIntentionallyTruncated""
},
{
"file_name": "InvoiceLineRichText.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYXRl/Base64EncodingIntentionallyTruncated"
],
"uom": "Hours"
}
]
}
],
"target_erp": ""
}'
다음 결과는 요청이 성공했으며 송장 데이터가 처리 중임을 보여줍니다. 송장 통합 로그 [sn_spend_intg_invoice_integration_log] 테이블에서 요청 상태를 볼 수 있습니다. 배치 ID 열에 나열된 배치 ID를 사용하여 송장을 찾습니다.
{
"batchId": "APIINV1729711710733280",
"status": "Success",
"message": "Your request has been successfully received and is being processed."
}
AP 송장 - POST sn_spend_intg/ap_invoice/xml
XML 형식의 자동 송장을 처리합니다.
송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블을 사용하여 필드가 XML 태그에 매핑되는 방식을 결정합니다.
URL 형식
버전이 지정된 URL: /api/sn_spend_intg/v1/ap_invoice/xml
기본 URL: /api/sn_spend_intg/ap_invoice/xml
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 경로 | 설명 |
|---|---|
| /Invoice/AmountInvoiced | 세금 및 배송료를 포함하여 공급자에게 지불해야 할 총 금액입니다. 대상 필드: u_amount_invoiced 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| 송장/BillToCity | 송장이 전송되는 도시입니다. 대상 필드: u_bill_to_city 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /Invoice/BillToCountry | 송장이 전송되는 국가(ISO 3166 형식)입니다. 예: US.대상 필드: u_bill_to_country 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /Invoice/BillToStateOrProvince | 송장이 전송되는 시 또는 도입니다. 대상 필드: u_bill_to_state_or_province 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /송장/BillToStreet | 송장이 전송되는 도로명 주소입니다. 대상 필드: u_bill_to_street 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /Invoice/BillToZipOrPostalCode | 송장이 전송되는 우편번호입니다. 대상 필드: u_bill_to_zip_or_postal_code |
| /송장/통화 | 필수. 소계, 세금 및 배송비에 대한 통화입니다. 소계, 세금 및 배송은 동일한 통화여야 합니다. 대상 필드: u_currency 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /invoice/dateFormat | 송장 날짜 형식을 기본 YYYY-MM-DD에서 지원되는 다른 날짜 형식으로 설정합니다. 날짜 값은 요소에 설정됩니다 InvoiceDate . 지원되는 날짜 형식:
주: MMM 형식 항목은 처음 세 글자로 된 월을 나타냅니다(예: Aug). MMMM 형식 항목은 전체 월 이름(예: 8월)을 나타냅니다. 대상 필드: u_date_format 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 기본 형식: YYYY-MM-DD |
| /송장/할인 | 송장에 적용되는 할인입니다. 대상 필드: u_discounts 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /invoice/ExternalInvoiceNumber | 외부 공급업체 애플리케이션에서 생성된 송장 번호입니다. 대상 필드: u_external_invoice_number 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /송장/송장 날짜 | 고객이 송장을 처리한 날짜입니다.DateFormat 요소를 사용하여 기본이 아닌 지원되는 형식으로 날짜를 추가합니다. 대상 필드: u_invoice_date 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] 기본 형식: YYYY-MM-DD |
| /송장/LegalEntity | 공급자의 법인 이름입니다. 법인 [sn_fin_legal_entity] 테이블에 있습니다. 대상 필드: u_legal_entity 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /Invoice/OtherCharges | 송장과 관련된 기타 추가 요금입니다. 편집 가능한 필드입니다. 대상 필드: u_other_charges 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /송장/지불 조건 | 공급자에 대한 지불이 이루어지는 합의된 시간과 조건입니다. 예를 들어, Net 30입니다.대상 필드: u_payment_terms 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /송장/송금 주소 | 지불이 이루어지는 도로명 주소입니다. 대상 필드: u_remit_address |
| 송장/송금 도시 | 지불이 이루어지는 도시입니다. 대상 필드: u_remit_to_city |
| /송장/송금 대상 국가 | 지불이 이루어지는 국가(ISO 3166 형식)입니다. 예: US.대상 필드: u_remit_to_country |
| /송장/RemitToStateOrProvince | 지불이 이루어지는 시 또는 도입니다. 대상 필드: u_remit_to_state_or_province |
| /Invoice/RemitToZipOrPostalCode | 지불이 이루어지는 우편번호입니다. 대상 필드: u_remit_to_zip_or_postal_code |
| /invoice/ShipFromCity | 구매 주문서의 항목이 배송된 출발지 도시입니다. 대상 필드: u_ship_from_city 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /송장/ShipFromCountry | 구매 주문서의 항목이 배송된 출발지 국가입니다. 대상 필드: u_ship_from_country 관련 테이블: 송장 라인 [sn_spend_intg_imp_invoice] |
| /송장/ShipFromStateOrProvince | 구매 주문서의 항목이 배송된 출발지 주/도입니다. 대상 필드: u_ship_from_state_or_province 관련 테이블: 송장 라인 [sn_spend_intg_imp_invoice] |
| /송장/ShipFromStreet | 구매 주문서의 항목이 배송된 출발지 거리입니다. 대상 필드: u_ship_from_street 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /invoice/ShipFromZipOrPostalCode | 구매 주문서의 항목이 배송된 출발지 우편번호입니다. 대상 필드: u_ship_from_zip_or_postal_code 관련 테이블: 송장 라인 [sn_spend_intg_imp_invoice] |
| /송장/배송 금액 | 전체 구매에 대한 총 배송 비용입니다. 대상 필드: u_shipping_amount 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /송장/소계 | 세금 및 배송료를 제외하고 공급자에게 지불할 총 금액입니다. 대상 필드: u_subtotal 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /송장/공급자 | 고객이 주문할 수 있는 리셀러 또는 공급자의 식별자입니다. 대상 필드: u_supplier 관련 테이블: 송장 임포트 [sn_spend_intg_imp_invoice] |
| /Invoice/SupportingAttachments | 외상 매입금 전문가에게 할당된 케이스에 대해 송장 처리 케이스 수준에서 정의된 첨부 파일 목록입니다. Invoice processing case form 문서를 참조하십시오. 생성되면 시스템은 연결된 송장 케이스 및 송장 라인과 함께 송장 기록을 생성합니다. 첨부 파일은 그에 따라 해당 기록에 연결됩니다. |
| /Invoice/SupportingAttachments/Attachment/ | 단일 첨부 파일에 대한 세부 정보를 포함합니다. |
| /Invoice/SupportingAttachments/Attachment/Content | 첨부 파일의 Base64 인코딩 파일 콘텐츠입니다. |
| /invoice/SupportingAttachments/첨부 파일/인코딩 | 이 값은 항상 base64입니다. |
| /Invoice/SupportingAttachments/Attachment/FileName | 첨부 파일의 파일 이름입니다. 주: 첨부 파일 이름에 예약된 "SD_" 접두사를 사용하지 마십시오. |
| /invoice/SupportingAttachments/Attachment/MimeCode | 이 값은 항상 base64입니다. |
| /Invoice/InvoiceCopyAttachment/ | 송장 수준에서 정의된 첨부 파일 목록입니다. Accounts Payable Invoice Processing 문서를 참조하십시오. 생성되면 시스템은 연결된 송장 케이스 및 송장 라인과 함께 송장 기록을 생성합니다. 첨부 파일은 그에 따라 해당 기록에 연결됩니다. |
| /Invoice/InvoiceCopyAttachment/Attachment/ | 단일 첨부 파일에 대한 세부 정보를 포함합니다. |
| /Invoice/InvoiceCopyAttachment/Attachment/Content | 첨부 파일의 Base64 인코딩 파일 콘텐츠입니다. |
| /Invoice/InvoiceCopyAttachment/첨부 파일/인코딩 | 이 값은 항상 base64입니다. |
| /Invoice/InvoiceCopyAttachment/Attachment/FileName | 첨부 파일의 파일 이름입니다. 주: 첨부 파일 이름에 예약된 "SD_" 접두사를 사용하지 마십시오. |
| /invoice/InvoiceCopyAttachment/Attachment/MimeCode | 이 값은 항상 base64입니다. |
| /송장/송장라인/ | 이 주문 내의 구매에 대해 송장 처리되는 라인을 정의하는 InvoiceLine 요소의 목록입니다. |
| /송장라인/ | 송장 라인 정의입니다. 송장 라인은 송장 라인 임포트 인바운드[sn_spend_intg_imp_invoice_line] 테이블에서 준비됩니다. |
| /송장라인/첨부 파일/ | 단일 첨부 파일에 대한 세부 정보를 포함합니다. |
| /invoiceLine/첨부 파일/내용 | 첨부 파일의 Base64 인코딩 파일 콘텐츠입니다. |
| /InvoiceLine/첨부 파일/인코딩 | 이 값은 항상 base64입니다. |
| /InvoiceLine/첨부 파일/파일 이름 | 첨부 파일의 파일 이름입니다. 주: 첨부 파일 이름에 예약된 "SD_" 접두사를 사용하지 마십시오. |
| /송장라인/첨부 파일/MIME 코드 | 이 값은 항상 base64입니다. |
| /송장라인/CostCenter | 송장이 생성되는 비용 센터의 계정 번호입니다. 비용 센터 [cmn_cost_center] 테이블에 나열됩니다. 대상 필드: u_cost_center |
| /송장라인/통화 | 라인 항목의 통화입니다. 예: USD대상 필드: u_currency 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /송장라인/GLAccount | 송장을 생성하는 데 사용되는 GL(총계정원장)의 계정 번호입니다. 대상 필드: u_gl_account |
| /InvoiceLine/LineAmountInvoiced | 지정된 구매 주문 라인에 대해 고객에게 송장이 발행되는 총 비용(세금 및 배송 제외)입니다. 대상 필드: u_line_amount_invoiced 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/LineDescription | 송장 라인에 대한 설명입니다. 대상 필드: u_line_description |
| /InvoiceLine/LineQuantity | 고객이 송장을 발행하는 상품 또는 서비스의 수량입니다. 대상 필드: u_line_quantity |
| /InvoiceLine/LineUnitPrice | 송장 내 라인 항목의 단가입니다. 대상 필드: u_line_unit_price 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/POLineDescription | 송장의 구매 주문서 라인에 대한 설명입니다. 대상 필드: u_po_line_description 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/구매 주문서 라인 | 이 주문에 대해 고객이 제공한 구매 주문서 번호입니다. 구매 주문서 [sn_shop_purchase_order] 테이블에 나열됩니다. 대상 필드: u_purchase_order 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /송장라인/ShipToCity | 구매 주문서의 항목이 배송된 목적지 도시입니다. 대상 필드: u_ship_to_city 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/ShipToCountry | 구매 주문서의 항목이 배송된 목적지 국가입니다. 대상 필드: u_ship_to_country 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/ShipToStateOrProvince | 구매 주문서의 항목이 배송된 목적지 시/도입니다. 대상 필드: u_ship_to_state_or_province |
| /송장라인/ShipToStreet | 구매 주문서의 항목이 배송된 목적지 거리입니다. 대상 필드: u_ship_to_street 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/ShipToZipOrPostalCode | 구매 주문서의 항목이 배송된 목적지 우편번호입니다. 대상 필드: u_ship_to_zip_or_postal_code 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /송장라인/소계 | 세금 및 배송료를 제외하고 공급자에게 지불할 총 금액입니다. 대상 필드: u_subtotal 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /송장라인/SupplierPartNumber | 이 송장 라인에 대해 공급자가 생성하는 파트 번호입니다. 대상 필드: u_supplier_part_number 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /송장라인/TaxCode | ERP 소스에서 생성된 고유 세금 코드입니다. 대상 필드: u_tax_code 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /송장 라인/UOM | 송장의 항목을 계산하는 데 사용되는 UOM(기본 측정 단위)입니다. 대상 필드: u_uom 관련 테이블: 송장 라인 임포트 [sn_spend_intg_imp_invoice_line] |
| /TaxDetail/TaxType | 송장에 적용할 수 있는 세금 유형입니다. 세금 유형 [sn_fin_tax_type] 테이블에 나열됩니다. 대상 필드: u_tax_type 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] |
| /TaxDetail/TaxRate | 공급자가 부과한 세율입니다. 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] 대상 필드: u_supplier_tax_rate 관련 테이블: 송장 세금 라인 임포트 [sn_spend_intg_imp_invoice_tax_line] |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. .만 지원합니다 application/xml. |
| 소스-시스템 | 요청이 들어오는 소스 시스템을 지정합니다. 사용 가능한 시스템은 소스 시스템 자격 증명 [sn_spend_intg_source_system_credential] 테이블에 나열됩니다. 이 설정은 제공된 요청이 송장 통합 필드 매핑 [sn_spend_intg_invoice_intg_field_mapping] 테이블의 구조를 따르는지 확인하는 데 도움이 됩니다. 이 설정은 소스 시스템 자격 증명 [sn_spend_intg_source_system_credential] 테이블에서 자격 증명을 가져오는 데에도 사용됩니다. |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 202 | 요청이 수락되었습니다. 요청이 성공했으며 송장 처리가 진행 중입니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 429 | 요청이 너무 많습니다. 요청 속도가 시간당 최대 10개 요청을 초과했습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| batch_id | 배치 요청의 고유 식별자입니다. 이 ID는 요청 상태를 추적하는 데 사용할 수 있습니다. 이 기록은 송장 통합 로그 [sn_spend_intg_invoice_integration_log] 테이블에 저장됩니다. 데이터 유형: 문자열 |
| 오류 | 요청이 실패할 때의 오류 메시지와 세부 정보를 포함합니다.데이터 유형: 객체 |
| 오류.상세 정보 | 요청 오류에 대한 추가 상세 정보입니다. 가능한 결과:
데이터 유형: 문자열 |
| 오류.메시지 | 요청이 실패한 이유를 포함하는 오류 메시지 가능한 오류:
데이터 유형: 문자열 |
| 메시지 | 성공 메시지(예: 요청이 성공적으로 수신되어 처리 중임)입니다. 송장 통합 로그 [sn_spend_intg_invoice_integration_log] 테이블에서 요청 상태를 볼 수 있습니다. 데이터 유형: 문자열 |
| 상태 | 요청의 결과를 나타냅니다. 가능한 값:
데이터 유형: 문자열 |
cURL 요청
다음 예는 XML 형식의 요청으로 제공된 송장을 처리하는 방법을 보여줍니다. Base64 인코딩은 크기가 다양하며 매우 클 수 있습니다. 공간 절약을 위해 컨텐츠 값이 잘렸습니다. 정보는 적절한 페이로드 구조를 반영합니다.
curl -X POST https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/xml \
-H "Source-System: Ariba" \
-H "Content-Type: application/json" \
-d '<Invoices>
<Invoice>
<InvoiceType>po_invoice</InvoiceType>
<SupplierInvoiceNumber>S-AttachmentInvoice-A1-SupportDoc1</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#00A1</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<PurchaseOrder>###0004889698</PurchaseOrder>
<BusinessOwner>paula.smith@example.com</BusinessOwner>
<DateFormat>DD-MMM-YY</DateFormat>
<InvoiceDate>16-DEC-24</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>US</LegalEntity>
<Subtotal>100.00</Subtotal>
<ShippingAmount>20.00</ShippingAmount>
<OtherCharges>20</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>150.00</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<TaxDetails>
<TaxDetail>
<TaxType>Sales tax</TaxType>
<TaxAmount>10</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>CGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>11</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>IGST</TaxType>
<TaxAmount>12</TaxAmount>
<TaxRate>12</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount>13</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
</TaxDetails>
<SupportingAttachments>
<Attachment>
<FileName>InvoiceCaseSupportingDoc.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>InvoiceImageA1.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</SupportingAttachments>
<InvoiceCopyAttachment>
<Attachment>
<FileName>InvoiceA1.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>InvoiceImageA1.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</InvoiceCopyAttachment>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-#00A1</ExternalInvoiceNumber>
<LineDescription>Invoice_Line_Attach_A1</LineDescription>
<PurchaseOrderLine>POL11232</PurchaseOrderLine>
<POLineDescription>NowX Charger</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>200.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00001</CostCenter>
<GLAccount>100005</GLAccount>
<TaxCode>A1 - Sales tax, reduced rate</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<Attachments>
<Attachment>
<FileName>InvoiceLineA1.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMT/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</Attachments>
</InvoiceLine>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-#00A</ExternalInvoiceNumber>
<LineDescription>InvoiceLine_PDF_Attach_A1</LineDescription>
<PurchaseOrderLine>00048896981</PurchaseOrderLine>
<POLineDescription></POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>200.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>120050</GLAccount>
<TaxCode>A1 - Sales tax, reduced rate</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<Attachments>
<Attachment>
<FileName>Invoice_line_A1.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBER/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>InvoiceImageA1.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</Attachments>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType>non_po_invoice</InvoiceType>
<SupplierInvoiceNumber>10MultiAttach_Inv_invline_A2-MultiSupp</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#00A2</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<BusinessOwner>paula.smith@example.com</BusinessOwner>
<DateFormat>DD-MMM-YYYY</DateFormat>
<InvoiceDate>10-Nov-2024</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>1100</LegalEntity>
<Subtotal>120.00</Subtotal>
<ShippingAmount>10.00</ShippingAmount>
<OtherCharges>10</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>150.00</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<TaxDetails>
<TaxDetail>
<TaxType>Value added tax</TaxType>
<TaxAmount>8</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>7</TaxRate>
</TaxDetail>
</TaxDetails>
<SupportingAttachments>
<Attachment>
<FileName>10InvoiceCaseTestInv_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCasePNGInv_Xml_A2.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvceCaseTst2Inv_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseTestXMLINV_Xml_A2.xml</FileName>
<MimeCode>text/xml</MimeCode>
<Encoding>base64</Encoding>
<Content>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kY/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseTestExcelINV_Xml_A2.xlsx</FileName>
<MimeCode>application/vnd.ms-excel</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseTestdocINV_Xml_A2.docx</FileName>
<MimeCode>application/vnd.openxmlformats-officedocument.wordprocessingml.document</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCasePPT_Xml_A2.pptx</FileName>
<MimeCode>application/vnd.ms-powerpoint</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseRichText_Xml_A2.rtf</FileName>
<MimeCode>application/rtf</MimeCode>
<Encoding>base64</Encoding>
<Content>e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2Nv/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseImageJpeg_XML_A2.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</SupportingAttachments>
<InvoiceCopyAttachment>
<Attachment>
<FileName>10InvoiceTestInv_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoicePNGInv_Xml_A2.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvceTst2Inv_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestXMLINV_Xml_A2.xml</FileName>
<MimeCode>text/xml</MimeCode>
<Encoding>base64</Encoding>
<Content>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kY/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestExcelINV_Xml_A2.xlsx</FileName>
<MimeCode>application/vnd.ms-excel</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestCSVINV_Xml_A2.csv</FileName>
<MimeCode>text/csv</MimeCode>
<Encoding>base64</Encoding>
<Content>Im51bWJlciIsInN1cHBsaWVyX2ludm9pY2VfbnVtYmVyIiwic3VwcGxp/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestJsonINV_Xml_A2.json</FileName>
<MimeCode>application/json</MimeCode>
<Encoding>base64</Encoding>
<Content>eyJyZWNvcmRzIjpbeyJyZXF1aXJlc19hY2tub3dsZWRnZW1lbnQiOiJmY/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestdocINV_Xml_A2.docx</FileName>
<MimeCode>application/vnd.openxmlformats-officedocument.wordprocessingml.document</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoicePPT_Xml_A2.pptx</FileName>
<MimeCode>application/vnd.ms-powerpoint</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceRichText_Xml_A2.rtf</FileName>
<MimeCode>application/rtf</MimeCode>
<Encoding>base64</Encoding>
<Content>e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2Nv/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceImageJpeg_XML_A2.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</InvoiceCopyAttachment>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-#00A2</ExternalInvoiceNumber>
<LineDescription>Apple_MultiAttach_A2</LineDescription>
<PurchaseOrderLine>48896981</PurchaseOrderLine>
<POLineDescription>Keyboards</POLineDescription>
<LineQuantity>12</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>(200.00)</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>141100</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>2</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>IGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>3</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>IGST</TaxType>
<TaxAmount>5</TaxAmount>
<TaxRate>4</TaxRate>
</TaxDetail>
</TaxDetails>
<Attachments>
<Attachment>
<FileName>10InvoiceTestInvLine_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBER/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvcPNGInvLine_Xml_A2.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMT/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvTst2InvLine_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBER/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestXMLINVLine_Xml_A2.xml</FileName>
<MimeCode>text/xml</MimeCode>
<Encoding>base64</Encoding>
<Content>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIH/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestExcelINVLine_Xml_A2.xlsx</FileName>
<MimeCode>application/vnd.ms-excel</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbn/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestCSVINVLine_Xml_A2.csv</FileName>
<MimeCode>text/csv</MimeCode>
<Encoding>base64</Encoding>
<Content>Im51bWJlciIsInN1cHBsaWVyX2ludm9pY2VfbnVtYmVyIiwic/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestJsonINVLine_Xml_A2.json</FileName>
<MimeCode>application/json</MimeCode>
<Encoding>base64</Encoding>
<Content>eyJyZWNvcmRzIjpbeyJyZXF1aXJlc19hY2tub3dsZWRnZW1lb/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestdocINVLine_Xml_A2.docx</FileName>
<MimeCode>application/vnd.openxmlformats-officedocument.wordprocessingml.document</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlb/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceLinePPT_Xml_A2.pptx</FileName>
<MimeCode>application/vnd.ms-powerpoint</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlb/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceLineRichText_Xml_A2.rtf</FileName>
<MimeCode>application/rtf</MimeCode>
<Encoding>base64</Encoding>
<Content>e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvcImageJPG_InvcLine_Xml_A2.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</Attachments>
</InvoiceLine>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-#002</ExternalInvoiceNumber>
<LineDescription>Negative Tax</LineDescription>
<PurchaseOrderLine>48896981</PurchaseOrderLine>
<POLineDescription>Keyboards</POLineDescription>
<LineQuantity>12</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>200.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00001</CostCenter>
<GLAccount>100001</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>Value added tax</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>6</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount>16</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType></InvoiceType>
<SupplierInvoiceNumber>Both taxes</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#008</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<OriginalInvoice></OriginalInvoice>
<PurchaseOrder>###0004889698</PurchaseOrder>
<BusinessOwner>paula.smith@example.com</BusinessOwner>
<DateFormat>DD MMMM, YY</DateFormat>
<InvoiceDate>5 June, 24</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>1100</LegalEntity>
<Subtotal>100.00</Subtotal>
<ShippingAmount>10.00</ShippingAmount>
<OtherCharges>10-</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>130.00</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>21</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>IGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>23</TaxRate>
</TaxDetail>
</TaxDetails>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine>#ABC00048896981</PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>-200.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>100001</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>12</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType>credit_memo</InvoiceType>
<SupplierInvoiceNumber>no taxes</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#009</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<OriginalInvoice>Both taxes</OriginalInvoice>
<PurchaseOrder></PurchaseOrder>
<BusinessOwner>Paula Smith</BusinessOwner>
<DateFormat></DateFormat>
<InvoiceDate>2024-06-03</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>US</LegalEntity>
<Subtotal>100.00</Subtotal>
<ShippingAmount>10.00</ShippingAmount>
<OtherCharges>10</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>130.00</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine>#ABC00048896981</PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00-</LineUnitPrice>
<Subtotal>100.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>141200</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
</InvoiceLine>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine>#ABC00048896981</PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>100.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00001</CostCenter>
<GLAccount>100002</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType></InvoiceType>
<SupplierInvoiceNumber>LineLevelTaxes</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#0010</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<PurchaseOrder></PurchaseOrder>
<BusinessOwner>Paula Smith</BusinessOwner>
<DateFormat>MMM DD, YYYY</DateFormat>
<InvoiceDate>Aug 3, 2024</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>US</LegalEntity>
<Subtotal>100</Subtotal>
<ShippingAmount>10</ShippingAmount>
<OtherCharges>10</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>10</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121$%ad</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine></PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>20</LineUnitPrice>
<Subtotal>-200¥</Subtotal>
<LineAmountInvoiced>200$</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>141300</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001ACD@</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>12</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>CGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>15</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount>13</TaxAmount>
<TaxRate>13</TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType></InvoiceType>
<SupplierInvoiceNumber>LineLevelTaxes</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#0010</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<PurchaseOrder></PurchaseOrder>
<BusinessOwner>Paula Smith</BusinessOwner>
<DateFormat>MMMM DD, YYYY</DateFormat>
<InvoiceDate>september 1st, 2024</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>US</LegalEntity>
<Subtotal>100</Subtotal>
<ShippingAmount>10</ShippingAmount>
<OtherCharges>10</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>10</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121$%ad</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine></PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>20</LineUnitPrice>
<Subtotal>-200¥</Subtotal>
<LineAmountInvoiced>200$</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>141300</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001ACD@</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>12</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>CGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>15</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount>13</TaxAmount>
<TaxRate>13</TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<TargetERP>ERP1</TargetERP>
</Invoices>'
다음 결과는 요청이 성공했으며 송장 데이터가 처리 중임을 보여줍니다. 송장 통합 로그 [sn_spend_intg_invoice_integration_log] 테이블에서 요청 상태를 볼 수 있습니다. 배치 ID 열에 나열된 배치 ID를 사용하여 송장을 찾습니다.
{
"batchId": "APIINV1736249646168148",
"status": "Success",
"message": "Your request has been successfully received and is being processed."
}