latestOpenAPI 3.0.32026-08-101200629.5 KB

2c51a28d0f48

Vendas

Documentos de Venda

Criar Documento de Venda

post/api/v1/commercial_sales_documents

Request body

apply_retention_when_paidboolean

currency_conversion_ratenumber

currency_iso_codestring

customer_address_detailstring

customer_business_namestring

customer_citystring

customer_countrystring

customer_postcodestring

customer_tax_registration_numberstring

datestring

document_typestring

due_datestring

external_referencestring

finalizeboolean

linesobject[]

notesstring

operation_countrystring

payment_mechanismstring

retentionnumber

retention_typestring

settlement_expressionstring

vat_included_pricesboolean

Example request

{
  "apply_retention_when_paid": true,
  "currency_conversion_rate": 1.21,
  "currency_iso_code": "EUR",
  "customer_address_detail": "Praceta da Liberdade n5",
  "customer_business_name": "Ricardo Ribeiro",
  "customer_city": "Lisboa",
  "customer_country": "PT",
  "customer_postcode": "1000-101",
  "customer_tax_registration_number": "229659179",
  "date": "2023-01-01",
  "document_type": "FT",
  "due_date": "2023-02-01",
  "external_reference": "Referência do documento externo",
  "lines": [
    {}
  ],
  "notes": "Notas ao documento",
  "operation_country": "PT-MA",
  "payment_mechanism": "MO",
  "retention": 7.5,
  "retention_type": "IRS",
  "settlement_expression": "7.5"
}