Create Document

post https://api.holded.com/api/invoicing/v1/documents/{docType}

Create a new document type.

❗️
Matching products or services
To match products or services you have already created inside Holded, you can use the "sku" field for products, or the "serviceId" field for services.

❗️
Purchase notes / Purchases receipts
If you want to create a purchase receipt, you will need to set the docType as purchase and add this field in your JSON:

"isReceipt": true

Path Params

docType

string

required

docType should be one of: {invoice, salesreceipt, creditnote, salesorder, proform, waybill,estimate, purchase, purchaseorder or purchaserefund}

Body Params

applyContactDefaults

boolean

Contact defaults are applied by default. If you don't want to apply it, set this field to false

contactCode

string

(NIF / CIF / VAT) Field required if you want to choose an existing contact and contactId field is empty

contactId

string

(Contact ID) Field required if you want to choose an existing contact and contactCode field is empty

contactName

string

Field required if contactCode and contactId fields are empty and you want to create a new contact

contactEmail

string

contactAddress

string

contactCity

string

contactCp

string

contactProvince

string

contactCountryCode

string

desc

string

date

integer

required

notes

string

salesChannelId

string

Set an existing account id

paymentMethodId

string

designId

string

language

string

warehouseId

string

Choose the warehouse for your salesorder, purchaseorder or waybill.

approveDoc

boolean

Choose if the document needs to be approved or not. The default option is False.

items

array of objects

items

customFields

array of objects

customFields

invoiceNum

string

numSerieId

string

currency

string

currencyChange

number

tags

dueDate

integer

shippingAddress

string

shippingPostalCode

string

shippingCity

string

shippingProvince

string

shippingCountry

string

salesChannel

number

Response

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.holded.com/api/invoicing/v1/documents/docType \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Create Document

❗️
Matching products or services

❗️
Purchase notes / Purchases receipts

❗️Matching products or services

❗️Purchase notes / Purchases receipts

201

❗️
Matching products or services

❗️
Purchase notes / Purchases receipts