POST
/
supplier_invoices
/
import
{
  "invoice_number": "<string>",
  "currency": "AED",
  "amount": "<string>",
  "currency_amount": "<string>",
  "currency_amount_before_tax": "<string>",
  "date": "<string>",
  "deadline": "<string>",
  "currency_tax": "<string>",
  "tax": "<string>",
  "id": 123,
  "label": "<string>",
  "exchange_rate": "<string>",
  "public_file_url": "<string>",
  "filename": "<string>",
  "remaining_amount_with_tax": "<string>",
  "remaining_amount_without_tax": "<string>",
  "archived_at": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "v1_external_id": "<string>",
  "v2_id": 123,
  "supplier": {
    "id": 123,
    "url": "<string>"
  },
  "source": "billy_import",
  "reconciled": true,
  "external_reference": "<string>",
  "payment_status": "to_be_processed"
}

Headers

​
x-source
enum<string>
Available options:
billy
​
x-source-software
enum<string>
Available options:
EASYBEER,
AMAZON,
AMAZONSELLER,
AXONAUT,
HARVEST,
HUBSPOT,
PENNYLANE,
ZOHO,
CHARGEBEE,
SELLSY,
VOSFACTURES,
FACTOMOS,
BOONDMANAGER,
TEAMLEADER,
CHORUSPRO,
DOLIBARR,
PROGBAT,
EVOLIZ,
RECURLY,
KARLIA,
PIPEDRIVE,
SHOPIFY,
ODOO,
LAGO,
SALESFORCE,
HYPERLINE,
RENTMAN,
SPENDESK,
WEEBATI,
PROABONO,
WOOCOMMERCE,
PRESTASHOP,
MAGENTO,
SQUARESPACE,
BIGCOMMERCE,
SYLIUS,
ORGANILOG,
XERO,
ZETTLE,
SUMUP,
METRO,
VSA

Body

application/json

Body

​
file_attachment_id
number
required
​
supplier_id
number
required
​
date
string
required
​
deadline
string
required
​
invoice_number
string
required
Minimum length: 1
​
currency_amount_before_tax
string
required
​
currency_amount
string
required
​
currency_tax
string
required
​
invoice_lines
object[]
required
​
import_as_incomplete
boolean
​
currency
default:EUR
Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTC,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLP,
CNY,
COP,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRO,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SSP,
STD,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VES,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
BCH,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
YER,
ZAR,
ZMW,
ZWL
​
amount
string

Invoice amount in euros (total value of the invoice in euros). If the currency is euro, currency_amount and amount are identical.

​
tax
string
​
transaction_reference
object

Response

201

​
invoice_number
string
required
​
currency
enum<string>
required
Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTC,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLP,
CNY,
COP,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRO,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SSP,
STD,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VES,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
BCH,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
YER,
ZAR,
ZMW,
ZWL
​
amount
string
required
​
currency_amount_before_tax
string
required
​
id
number
required
​
exchange_rate
string
required
​
created_at
string
required
​
updated_at
string
required
​
reconciled
boolean
required
​
payment_status
enum<string>
required
Available options:
to_be_processed,
to_be_paid,
partially_paid,
payment_error,
payment_scheduled,
payment_in_progress,
payment_emitted,
payment_found,
paid_offline,
fully_paid
​
currency_amount
string
​
date
string | null
​
deadline
string | null
​
currency_tax
string
​
tax
string
​
label
string | null
​
public_file_url
string | null
​
filename
string | null
​
remaining_amount_with_tax
string | null
​
remaining_amount_without_tax
string | null
​
archived_at
string | null
​
v1_external_id
string | null
Maximum length: 2000
​
v2_id
number | null
​
supplier
object | null
​
source
enum<string> | null
Available options:
billy_import,
other,
email,
stripe,
quotes,
mobile,
web_customer_transactions,
external_api_import,
external_api_create,
qonto
​
external_reference
string
Maximum length: 2000