Invoices API (/invoices)

Overview

The URL to access invoices is: https://{your_instance_name}/api/invoices

For more information about integrations and troubleshooting, see Integration Best Practices.

Enable strict API validations

You can enable strict Invoice API validations by performing the following:

Go to Setup > Company Setup > Company Information.
From System Options > Invoices , select Enforce all invoice validations on invoice update and submit APIs (recommended).

The setting prevents invoices with non-editable custom fields or invoices with inactive billing accounts from being updated using the API. You may need to disable this setting.

Actions

The Invoices API allows you to:


Verb	Path	Action	Description
POST	`/api/invoices`	Create	Creates an invoice in draft status.
PUT	`/api/invoices/:id/abandon`	abandon	Abandon invoice
PUT	`/api/invoices/:id/add_approver`	Add approver	Manually add an approver for an invoice
PUT	`/api/invoices/:id/bypass_approvals`	Bypass approvals	Bypass approvals Allows a 3rd-party system on the customers side to get an invoice approved and paid as quickly as possible.
PUT	`/api/invoices/:id/bypass_current_approval`	Bypass current approval	Bypass current approval Allows a 3rd-party system on the customers side to get an invoice approved from the current approver to get an invoice paid as quickly as possible.
PUT	`/api/invoices/:id/dispute`	Dispute	Dispute invoice Allows moving an invoice to disputed status via a system call. Moving an invoice to disputed notifies the supplier that there is an issue with an invoice. The dispute request can include a dispute reason in the payload as follows: `<invoice-header> <dispute-reason> <code>INCORRECT-QUANTITY</code> </dispute-reason> <comment>A supplier comment</comment> </invoice-header>` This requires that INCORRECT_QUANTITY is a valid and active dispute reason.
PUT	`/api/invoices/:id/flip_to_advance_ship_notice`	Flip to advance ship notice	Flip invoice to Advance Ship Notice
GET	`/api/invoices/:id/retrieve_image_scan`	Retrieve image scan	Retrieve/Download image scan
PUT	`/api/invoices/:id/image_scan`	Image scan	Update image scan attachment or image scan URL
GET	`/api/invoices`	Index	Query invoices
PUT	`/api/invoices/:id/remove_approval`	Remove approval	Remove an approver who was manually added
PUT	`/api/invoices/:id/restart_approvals`	Restart approvals	Restart approvals Allows a 3rd-party system on the customers side to clear the current approval chain and regenerate an new approval chain for an invoice that has had modifications.
GET	`/api/invoices/:id/retrieve_clearance_document`	retrieve_clearance_document	Retrieve/Download clearance document
GET	`/api/invoices/:id/retrieve_legal_invoice_pdf`	retrieve_legal_invoice_pdf	Download/retrieve the legal invoice PDF. This action allows the PDF attachment to be exported by API call.
PUT	`/api/invoices/:id/revalidate_tolerances`	Revalidate tolerances	Revalidate tolerances Allows a 3rd-party system on the customers side to resubmit an invoice that had issues.
GET	`/api/invoices/:id`	Show	Show invoice
PUT	`/api/invoices/:id/submit`	Submit	Submit draft invoice for approval
PUT	`/api/invoices/:id`	Update	Update invoice Used to updated information on the Invoice using the API
PUT	`/api/invoices/:id/update_line_accounts`	Update line accounts	Update line accounts Used by mobile users to update Invoices
PUT	`/api/invoices/:id/void`	Void	Void an approved invoice This can be used on Invoices only on approved and pending receipt Invoices. BUYER_VOIDABLE_STATUSES = [:pending_receipt, :approved, :draft] SUPPLIER_VOIDABLE_STATUSES = [:pending_receipt, :approved]
PUT	`/api/invoices/:id/withdraw_dispute`	Withdraw dispute	Withdraw dispute Due to supplier inaction or a mistake on the buyer side a disputed Invoice can be returned to the approval process.
GET	`/api/invoices/:invoice_id/attachments`	List all attachments for an invoice	For complete details, refer to the Attachment API Documentation.
GET	`/api/invoices/:invoice_id/attachments/:attachment_id`	Get a single attachment	For complete details, refer to the Attachment API Documentation.
POST	`/api/invoices/:invoice_id/attachments`	Add attachments	For complete details, refer to the Attachment API Documentation.

Elements

Note: For invoice_date and original_invoice_date, provide the date only. Avoid adding the time stamp to prevent issues related to credit note linking.


Element	Description	Req'd	Unique	Allowable Value	In	Out	Data Type
abandon-reason	Abandon reason	no	no	any		yes	Reason Insight
account-type	Chart Of Account Reference	yes			yes	yes	Account Type
advance-payment-received-amount	Amount of advance payment received				yes	yes	decimal(30,4)
customer_account_number	Customer Account Number	no			yes	yes	string(225)
date-of-discovery-of-facts-decisive-for-correction	Date of Discovery of Facts Decisive for Correction	no			yes	yes	datetime
amount-due-less-discount	Amount due after applying the discount			any		yes	decimal
approvals	Approvals					yes	Approval
attachments						yes	Attachment
archive-entity-id	Archive Entity Id					yes	integer
bill-to-address	Bill to Address	yes			yes	yes	Address
buyer_representative_name	Buyer Representative Name				yes	yes	string(255)
buyer-tax-registration	Buyer tax registration	yes*				yes	Tax Registration
canceled	Indicates if transaction has been canceled					yes	boolean
cash-accounting-scheme-reference	Note if using cash accounting scheme				yes	yes	string(255)
clearance-document	Clearance document attachment file name. Accessible via /retrieve_clearance_document					yes	string
comments	comments				yes	yes	string(255)
compliant	Invoice compliance indicator					yes	boolean
confirmation	Confirmation					yes	string(50)
contract	Backing contract number				yes	yes	Contract
coupa-accelerate-status	Status indicating whether the invoice has discount payment terms via Static Discounting			accelerated		yes	string(40)
created-at	Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ					yes	datetime
created-by	User who created					yes	User
credit-note-differences-with-original-invoice	Credit Note Differences With Original Invoice				yes	yes	decimal(30,4)
credit-reason	The reason of creating the credit			any OR see the catalog fields section for more information	yes	yes	string(255)
currency	Currency code				yes	yes	Currency
current-integration-history-records	Current Integration History Records					yes	Integration History Record
customer-accounting-tax-less-discount	Customer accounting tax after applying the discount			any		yes	decimal
customs-declaration-date	Customs Declaration Date				yes	yes	datetime
customs-declaration-number	Customs Declaration Number				yes	yes	string(60)
customs-office	Customs Office				yes	yes	text
date-received	Date Received in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ					yes	datetime
delivery-date	Date of Supply	no	no	any		yes	datetime
destination-country	Country of destination used for compliance					yes	Country
discount-amount	Discount Amount provided by supplier				yes	yes	decimal(32,4)
discount-due-date	Discount Due Date calculated based on the discount payment terms					yes	datetime
discount-percent	Discount %				yes	yes	float
dispute-method	Dispute Method	no	no	any		yes	string(10)
dispute-reasons	Dispute Reasons	no	no	any		yes	Dispute Reason
document-type	Invoice or Credit Note			Invoice, Credit Note		yes	string(255)
early-payment-provisions	Early payment incentives				yes	yes	string(255)
exchange-rate	Exchange Rate				yes	yes	decimal(30,9)
exported	Indicates if transaction has been exported					yes	boolean
failed-tolerances	Failed tolerances				yes	yes	Invoice::FailedTolerance
folio-number	Folio Number				yes	yes	string(255)
form-of-payment	Payment Form					yes	string(10)
gross-total	Gross Total					yes	decimal
gross-total-less-discount	Invoice total after applying the discount			any		yes	decimal
handling-amount	Handling amount				yes	yes	decimal(32,4)
id	Coupa unique identifier					yes	integer
image-scan	Invoice Image Scan attachment filename					yes	string(25)
image-scan-content-type	Content type of image scan					yes	string(191)
image-scan-file-name	File name of the image scan					yes	string(255)
image-scan-file-size	Size of image scan file in MB					yes	string(12)
image-scan-url	Invoice Image Scan URL. Must begin with 'http://' or 'https://'.					yes	string(255)
inbound-invoice	Inbound invoice reference					yes	Inbound Invoice
inbox-name	Inbox Name					yes	string
internal-note	Internal Note				yes	yes	text
invoice-charges	Invoice charges				yes	yes	Invoice Charge
invoice-date	Date of Invoice	yes			yes	yes	datetime
invoice-from-address	Invoice from address	yes*				yes	Supplier Remit To
invoice-lines	Record identifier				yes	yes	Invoice Line
invoice-number	Invoice number	yes			yes	yes	string(40)
invoice-payment-receipts	Invoice related payment receipts information					yes	Invoice Payment Receipt
invoice-reference-number	Invoice Reference Number (IRN)				yes	yes	string(64)
issuance-place	Issuance Place					yes	string(50)
last-exported-at	Date and time transaction was last exported in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ				yes	yes	datetime
override-tax-country	Set Override Tax Country for Buyer Compliance Presentations	no		See the Country Code List.	yes		Country
late-payment-penalties	Late Payment Penalties				yes	yes	string(255)
legal-destination-country	Legal destination country used for compliance			See the Compliant Country List .		yes	Country
line-level-taxation	Flag indicating whether taxes are provided at line level in this invoice	yes			yes	yes	boolean
lock-version-key	Lock Version					yes	integer
margin-scheme	Reason for using margin scheme			any OR see the catalog fields section for more information	yes	yes	string(255)
misc-amount	Miscellaneous Amount				yes	yes	decimal(32,4)
net-due-date	Net Due Date calculated based on the net payment terms					yes	datetime
net-total-less-discount	Net total after applying the discount			any		yes	decimal
origin-country	Country of origin used for compliance					yes	Country
origin-currency-gross	Local Currency Gross	yes*				yes	decimal(32,4)
origin-currency-net	Local Currency Net	yes*				yes	decimal(32,4)
original-invoice-date	Original invoice date required when is-credit-note=true	yes**				yes	datetime
original-invoice-number	Original invoice date required when is-credit-note=true	yes**				yes	string(40)
paid	Paid				yes	yes	boolean
pay-invoice	Pay invoice					yes
payment-channel	How the invoice payment will be handled - ERP (default), Coupa Pay Virtual Card, Coupa Pay Invoice Payment	no	no	any		yes	string(40)
payment-date	Date of payment for invoice				yes	yes	datetime
payment-method	Payment Method					yes	string(10)
payment-notes	Notes included with payment for invoice				yes	yes	text
payment-order-reference	Payment Order Reference				yes	yes	string(255)
payment-term	Payment term code on invoice				yes	yes	Payment Term
payments	Payments				yes	yes	Payment
pre-payment-date	Pre-Payment Date				yes	yes	datetime
reconciliation-lines	Reconciliation lines				yes		Invoice/Reconciliation Line
remit-to-address	Remit to Address	yes			yes	yes	Remit To Address
requested-by	Requester on the invoice					yes	User
resolution-number	Resolution Number				yes	yes	string(255)
reverse-charge-reference	Reverse Charge Reference				yes	yes
self-billing-reference	Self billing reference on the invoice				yes	yes	string(191)
sender-email	Sender Email					yes	string(255)
series	Series				yes	yes	string(30)
ship-from-address	Ship from address	yes				yes	Supplier Remit To
ship-to-address	Ship to Address				yes	yes	Address
shipping-amount	Shipping Amount				yes	yes	decimal(32,4)
shipping-term	Shipping term code on invoice					yes	Shipping Term
show-tax-information	Show tax information in the invoice					yes	boolean
status	Invoice Status. For more information about invoice statuses, see Invoice Progression through Statuses.			new, ap_hold, draft, on_hold, pending_receipt, rejected, abandoned. disputed. pending_approval, booking_hold, pending_action, approved, voided, processing, invalid, pending_action, payable_adjustment		yes	string(50)
supplier	Supplier Name or Number				yes	yes	Supplier
supplier-created	Supplier created indicator for invoice					yes	boolean
supplier-note	Note provided by supplier				yes	yes	text
supplier-remit-to	Supplier provided remit to address	yes			yes	yes	Supplier Remit To
supplier-representative-name	Supplier Representative Name				yes	yes	string(255)
supplier-tax-registration	Supplier tax registration	yes*				yes	Tax Registration
supplier-total	Invoice control total				yes	yes	decimal
taggings	Taggings				yes	yes	Tagging
tags	Tag (Deprecated, please use Taggings association to add Tags onto InvoiceHeader)				yes	yes	Tag
tax-amount	Tax amount (not used if tax is provided at line level)				yes	yes	decimal
tax-amount-engine	Tax amount calculated by either Coupa Native or External Tax Engine based on configuration					yes	decimal
tax-code	Tax code (not used if tax is provided at line level)				yes	yes	string(255)
tax-code-engine	Tax code returned by External Tax Engine based on configuration					yes
tax-due-to-supplier	Tax due to the supplier					yes	decimal(32,4)
tax-lines	Line tax code (not used if tax is provided at header level)				yes	yes	Tax Line
tax-rate	Tax rate (not used if tax is provided at line level)				yes	yes	float
tax-rate-engine	Tax rate returned by External Tax Engine based on configuration					yes
taxes-in-origin-country-currency	Local Currency Tax	yes*				yes	decimal(32,4)
tolerance-failures	Tolerance Failure					yes	string(512)
total-with-taxes	Total with taxes					yes	decimal
total-taxes-less-discount	Total taxes after applying the discount			any		yes	decimal
type-of-receipt	Type of Receipt					yes	string(10)
updated-at	Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ					yes	datetime
updated-by	User who updated					yes	User
use-of-invoice	Use of the Invoice					yes	string(10)
withholding-tax-lines	Withholding tax lines				yes	yes	Withholding Tax Line
withholding-tax-override	Withholding Tax Override					yes	decimal(30,3)
supplier-invoice-reviewer-name	Supplier Invoice Reviewer NameName of invoice reviewer				yes	yes	string(255)
supplier-payment-collector-name	Name of payment collector				yes	yes	string(255)
new-means-of-transport	New Means Of Transport					yes	string(10)
amount-of-advance-payment	Amount Of Advance Payment				yes	yes	decimal(46,20)
transaction-uuid	Transaction UUID				yes	yes	string(50)
transaction-notification-date	Transaction Notification Date				yes	yes	datetime
content-validation	Invoice Content Validation Indicator					yes	boolean
supplier-invoice-issuer-name	Name of invoice issuer				yes	yes	string(255)
supplier-invoice-reviewer-name	Supplier Invoice Reviewer Name				yes	yes	string(255)
supplier-payment-collector-name	Supplier Payment Collector Name				yes	yes	string(255)
is-credit-note	Document Type Credit Note				yes		boolean
requester-email	Requester Email				yes		string
requester-name	Requester Fullname				yes		string
requester-lookup-name	Requester Lookup Name				yes		string
delivery-number	Delivery Number				yes	yes	string(255)
delivery-date	Date of delivery				yes	yes	datetime
original-value-of-supply	Original Value of Supply				yes	yes	decimal(46,20)
correct-value-of-supply	Correct Value of Supply				yes	yes	decimal(46,20)
original-invoice-date	Original invoice date used in case of a Credit Note	yes			yes		datetime
type-of-relationship	Type of Relationship				yes	yes	string(10)
original-invoice-number	Original invoice number used in case of a Credit Note	yes			yes		string(40)
place-of-supply	Place Of Supply				yes	yes	string(255)
split-payment-mechanism	Split Payment Mechanism				yes	yes	boolean
endorsement-on-invoices	Endorsement On Invoices				yes	yes	string(10)
new-means-of-transport	New Means Of Transport				yes	yes	string(10)
place-of-issuance	Place Of Issuance				yes		string(100)
signed-qr-code	Signed QR Code				yes	yes	text
shipping-term	Shipping term code on invoice				yes
supplier-tax-registration		yes			yes
buyer-tax-registration		yes			yes
payment-order-number	Payment Order Number				yes	yes	string
invoice-issuance-time	Invoice Issuance Time				yes	yes	string(255)
cash-register-operator	Cash Register Operator				yes	yes	string(255)
means-of-payment	Means Of Payment				yes	yes	string(255)
unique-identification-code-of-cash-receipt	Unique Identification Code Of Cash Receipt				yes	yes	string(255)
security-code-of-issuer	Security Code Of Issuer				yes	yes	string(255)
state-tax-number	State Tax ID Number				yes	yes	string(255)
state-tax-number-for-substitute-taxpayer	State Tax ID Number for Substitute Taxpayer				yes	yes	string(255)
municipal-tax-number	Municipality Tax ID Number				yes	yes	string(255)
serial-code-of-fiscal-invoice	Serial Code of Fiscal Invoice				yes	yes	string(255)
verification-code	Verification Code				yes	yes	string(255)
type-of-document	Type of Document			any OR see the catalog fields section for more information	yes	yes	string(255)
protocol-number	Protocol Number				yes	yes	string(255)
nature-of-operation	Nature of Operation				yes	yes	string(255)
type-of-operation	Type of Operation				yes	yes	string(255)
freight-type	Freight Type				yes	yes	string(255)
vehicle-license-plate	Vehicle License Plate				yes	yes	string(255)
national-enrollment-of-conveyor	National Enrollment of Conveyor				yes	yes	string(255)
volume-amount	Volume Amount				yes	yes	string(255)
volume-gross-weight	Volume Gross Weight				yes	yes	string(255)
volume-liquid-weight	Volume Liquid Weight				yes	yes	string(255)
volume-brand	Volume Brand				yes	yes	string(255)
volume-type	Volume Type				yes	yes	string(255)
volume-numbering	Volume Numbering				yes	yes	string(255)
payment-agreement-notes	Payment Agreement Notes			Fully paid via Prepayment Agreement, Partially paid via Prepayment Agreement, Already paid for a Recurring Agreement, Retain payment per agreement	yes		string(255)
tcs-tax-lines					yes		-
invoice-from-address		yes			yes		Address
ship-from-address		yes			yes		Address
vat-chargeability-system	VAT Chargeability System			any OR see the catalog fields section for more information	yes
buyer-representative-name	Buyer Representative Name				yes

Note:

Required fields marked with an asterisk * are additional required fields for compliant invoices. Required fields marked with two asterisks ** are only required when is-credit-note=true .
Fields highlighted in bold are flexible fields. These fields are not indexed. If one or more of these fields are used to query invoices via the API, the response time may be slower.

Country Specific Elements

This table defining which invoice elements are supported for each country's invoicing requirements. Each row indicates an element that is valid/supported for invoices in the specified country.


Element	Country Code
correct-value-of-supply	AE
credit-note-differences-with-original-invoice	AE
credit-reason	AE
exchange-rate	AE
margin-scheme	AE
original-value-of-supply	AE
cash-accounting-scheme-reference	AT
credit-reason	AT
exchange-rate	AT
margin-scheme	AT
credit-reason	AU
exchange-rate	AU
credit-reason	BD
exchange-rate	BD
cash-accounting-scheme-reference	BE
credit-reason	BE
exchange-rate	BE
margin-scheme	BE
cash-accounting-scheme-reference	BG
credit-reason	BG
early-payment-provisions	BG
exchange-rate	BG
margin-scheme	BG
new-means-of-transport	BG
credit-reason	BH
exchange-rate	BH
margin-scheme	BH
credit-reason	BR
exchange-rate	BR
folio-number	BR
freight-type	BR
municipal-tax-number	BR
national-enrollment-of-conveyor	BR
nature-of-operation	BR
protocol-number	BR
serial-code-of-fiscal-invoice	BR
series	BR
state-tax-number	BR
state-tax-number-for-substitute-taxpayer	BR
type-of-document	BR
type-of-operation	BR
vehicle-license-plate	BR
verification-code	BR
volume-amount	BR
volume-brand	BR
volume-gross-weight	BR
volume-liquid-weight	BR
volume-numbering	BR
volume-type	BR
credit-reason	CA
payment-term	CA
credit-reason	CH
early-payment-provisions	CH
exchange-rate	CH
late-payment-penalties	CH
credit-reason	CN
exchange-rate	CN
supplier-invoice-issuer-name	CN
supplier-invoice-reviewer-name	CN
supplier-payment-collector-name	CN
credit-reason	CO
exchange-rate	CO
resolution-number	CO
cash-accounting-scheme-reference	CZ
credit-note-differences-with-original-invoice	CZ
credit-reason	CZ
date-of-discovery-of-facts-decisive-for-correction	CZ
discount-percent	CZ
exchange-rate	CZ
margin-scheme	CZ
cash-accounting-scheme-reference	DE
credit-reason	DE
early-payment-provisions	DE
exchange-rate	DE
margin-scheme	DE
cash-accounting-scheme-reference	DK
credit-reason	DK
exchange-rate	DK
margin-scheme	DK
cash-accounting-scheme-reference	EE
credit-reason	EE
exchange-rate	EE
margin-scheme	EE
cash-accounting-scheme-reference	ES
credit-reason	ES
early-payment-provisions	ES
exchange-rate	ES
margin-scheme	ES
cash-accounting-scheme-reference	FI
credit-reason	FI
exchange-rate	FI
margin-scheme	FI
cash-accounting-scheme-reference	FR
credit-reason	FR
early-payment-provisions	FR
exchange-rate	FR
late-payment-penalties	FR
margin-scheme	FR
pre-payment-date	FR
cash-accounting-scheme-reference	GB
credit-reason	GB
early-payment-provisions	GB
exchange-rate	GB
margin-scheme	GB
cash-accounting-scheme-reference	GR
credit-reason	GR
exchange-rate	GR
margin-scheme	GR
new-means-of-transport	GR
invoice-reference-number	GR
cash-accounting-scheme-reference	HR
cash-register-operator	HR
credit-reason	HR
customs-declaration-date	HR
customs-declaration-number	HR
customs-office	HR
early-payment-provisions	HR
exchange-rate	HR
invoice-issuance-time	HR
late-payment-penalties	HR
margin-scheme	HR
means-of-payment	HR
security-code-of-issuer	HR
unique-identification-code-of-cash-receipt	HR
cash-accounting-scheme-reference	HU
credit-reason	HU
exchange-rate	HU
margin-scheme	HU
new-means-of-transport	HU
cash-accounting-scheme-reference	IC
credit-reason	IC
early-payment-provisions	IC
exchange-rate	IC
cash-accounting-scheme-reference	IE
credit-reason	IE
early-payment-provisions	IE
endorsement-on-invoices	IE
exchange-rate	IE
exchange-rate	IE
margin-scheme	IE
new-means-of-transport	IE
pre-payment-date	IE
credit-reason	IN
exchange-rate	IN
invoice-number	IN
invoice-reference-number	IN
place-of-supply	IN
signed-qr-code	IN
cash-accounting-scheme-reference	IT
credit-reason	IT
early-payment-provisions	IT
exchange-rate	IT
margin-scheme	IT
payment-schedule-terms	IT
vat-chargeability-system	IT
credit-reason	JP
exchange-rate	JP
gross-total	JP
buyer-representative-name	KR
credit-reason	KR
currency-id	KR
exchange-rate	KR
supplier-representative-name	KR
cash-accounting-scheme-reference	LT
credit-reason	LT
exchange-rate	LT
margin-scheme	LT
cash-accounting-scheme-reference	LU
credit-reason	LU
early-payment-provisions	LU
exchange-rate	LU
margin-scheme	LU
cash-accounting-scheme-reference	LV
credit-reason	LV
early-payment-provisions	LV
exchange-rate	LV
margin-scheme	LV
credit-reason	ME
margin-scheme	ME
credit-reason	MM
exchange-rate	MM
cash-accounting-scheme-reference	MT
credit-reason	MT
exchange-rate	MT
margin-scheme	MT
new-means-of-transport	MT
confirmation	MX
credit-reason	MX
customs-declaration-number	MX
early-payment-provisions	MX
folio-number	MX
form-of-payment	MX
issuance-place	MX
payment-method	MX
series	MX
type-of-receipt	MX
type-of-relationship	MX
use-of-invoice	MX
credit-reason	MY
exchange-rate	MY
gross-total	MY
invoice-reference-number	MY
signed-qr-code	MY
credit-reason	NA
exchange-rate	NA
cash-accounting-scheme-reference	NL
credit-reason	NL
exchange-rate	NL
margin-scheme	NL
credit-reason	NO
early-payment-provisions	NO
exchange-rate	NO
late-payment-penalties	NO
credit-reason	NZ
early-payment-provisions	NZ
exchange-rate	NZ
credit-reason	PK
exchange-rate	PK
advance-payment-received-amount	PL
cash-accounting-scheme-reference	PL
credit-reason	PL
customs-declaration-date	PL
customs-declaration-number	PL
customs-office	PL
early-payment-provisions	PL
exchange-rate	PL
margin-scheme	PL
pre-payment-date	PL
split-payment-mechanism	PL
cash-accounting-scheme-reference	PT
credit-reason	PT
exchange-rate	PT
margin-scheme	PT
new-means-of-transport	PT
cash-accounting-scheme-reference	RO
credit-reason	RO
early-payment-provisions	RO
exchange-rate	RO
gross-total	RO
margin-scheme	RO
amount-of-advance-payment	RS
cash-accounting-scheme-reference	RS
credit-reason	RS
exchange-rate	RS
gross-total	RS
margin-scheme	RS
place-of-issuance	RS
credit-reason	SA
exchange-rate	SA
cash-accounting-scheme-reference	SE
credit-reason	SE
early-payment-provisions	SE
exchange-rate	SE
margin-scheme	SE
credit-reason	SG
early-payment-provisions	SG
exchange-rate	SG
cash-accounting-scheme-reference	SI
credit-reason	SI
customs-declaration-date	SI
customs-declaration-number	SI
customs-office	SI
early-payment-provisions	SI
exchange-rate	SI
late-payment-penalties	SI
margin-scheme	SI
new-means-of-transport	SI
place-of-issuance	SI
cash-accounting-scheme-reference	SK
credit-reason	SK
customs-declaration-date	SK
customs-declaration-number	SK
customs-office	SK
discount-percent	SK
early-payment-provisions	SK
exchange-rate	SK
late-payment-penalties	SK
margin-scheme	SK
credit-reason	ZA
currency-id	ZA
early-payment-provisions	ZA
early-payment-provisions	ZA
exchange-rate	ZA

Catalog Fields

Catalog of permitted enumerated field values by country code. Maps country-specific invoice elements to their valid catalog codes and human-readable descriptions for tax compliance and invoice validation. For example: Poland (PL) "margin-scheme" accepts codes: P_PMarzy_2, P_PMarzy_3_1, etc.


Country Code	Element	Catalog Code	Catalog Description
IT	vat-chargeability-system	I	Immediata
IT	vat-chargeability-system	D	Differita
IT	vat-chargeability-system	S	Scissione dei pagamenti
BR	type-of-document	NF-e	NF-e
BR	type-of-document	NFS-e	NFS-e
BR	type-of-document	CT-e	CT-e
PL	margin-scheme	P_PMarzy_2	Biur podró?y
PL	margin-scheme	P_PMarzy_3_1	Towary u?ywane
PL	margin-scheme	P_PMarzy_3_2	Dzie?a sztuki
PL	margin-scheme	P_PMarzy_3_3	Przedmioty kolekcjonerskie i antyki
KR	credit-reason	1	기재사항의 착오·정정
KR	credit-reason	2	공급가액 변동
KR	credit-reason	3	환입
KR	credit-reason	4	계약의 해제
KR	credit-reason	5	내국신용장 사후 개설
KR	credit-reason	6	착오에 의한 이중발급

Compliant Country List

This list shows which countries are permitted for compliant invoicing. It is not a list of compliant countries Coupa currently supports.


#id	Code	Name
14	AU	Australia
15	AT	Austria
22	BE	Belgium
31	BR	Brazil
34	BG	Bulgaria
39	CA	Canada
53	HR	Croatia
55	CY	Cyprus
56	CZ	Czech Republic
58	DK	Denmark
67	EE	Estonia
72	FI	Finland
73	FR	France
79	DE	Germany
82	GB	United Kingdom
83	GR	Greece
96	HK	Hong Kong
97	HU	Hungary
98	IS	Iceland
103	IE	Ireland
104	IL	Israel
105	IT	Italy
108	JP	Japan
118	LV	Latvia
123	LI	Liechtenstein
124	LT	Lithuania
125	LU	Luxembourg
133	MT	Malta
138	MX	Mexico
141	MC	Monaco
144	MA	Morocco
151	NL	Netherlands
154	NZ	New Zealand
161	NO	Norway
171	PL	Poland
173	PT	Portugal
175	QA	Qatar
177	RO	Romania
183	SA	Saudi Arabia
187	SG	Singapore
188	SK	Slovakia
189	SI	Slovenia
192	ZA	South Africa
193	ES	Spain
204	SE	Sweden
205	CH	Switzerland
222	AE	United Arab Emirates
223	US	United States
250	IM	Isle Of Man

Coupa Documentation