invoices

Create invoice with file upload

Create a new invoice with optional file upload.

Translates VBA: UploadInvoice (multipart/form-data)

Accepts both database column names (A, B, F, G, H, etc.) and human-readable field names (emitente_nif, numero, atcud, etc.) from the frontend.

post/api/invoices

Request

  • Base URL
    https://api.multigest.pt (the document declares no server; this is the origin it was published from)
  • URL
    https://api.multigest.pt/api/invoices
  • Auth
    API key in header x-api-token and API key in header x-origin-verify

Headers

x-api-tokenstring nullable

Request body multipart/form-data

filestring binary nullable
Astring nullable

Emitter NIF (Portuguese 9-digit or foreign alphanumeric)

Bstring nullable

Acquirer NIF (Portuguese 9-digit or foreign alphanumeric)

Cstring nullable
Dstring nullable
Estring nullable
Fstring nullable

Document date YYYY-MM-DD

Gstring nullable

Invoice number

Hstring nullable

ATCUD

I1string nullable
I2number nullable
I3number nullable
I4number nullable
I5number nullable
I6number nullable
I7number nullable
I8number nullable
J1string nullable
J2number nullable
J3number nullable
J4number nullable
J5number nullable
J6number nullable
J7number nullable
J8number nullable
K1string nullable
K2number nullable
K3number nullable
K4number nullable
K5number nullable
K6number nullable
K7number nullable
K8number nullable
Lnumber nullable
Mnumber nullable
Nnumber nullable

Tax total

Onumber nullable

Grand total

Pnumber nullable
Qstring nullable
Rstring nullable
Sstring nullable
Descricaostring nullable
tipodocsinteger nullable

Document type ID

emitente_nifstring nullable

Emitter NIF (maps to A)

adquirente_nifstring nullable

Acquirer NIF (maps to B)

data_documentostring nullable

Document date (maps to F)

numerostring nullable

Invoice number (maps to G)

atcudstring nullable

ATCUD (maps to H)

base_tributavelnumber nullable

Tax base (maps to I7)

total_ivanumber nullable

Total VAT (maps to N)

totalnumber nullable

Grand total (maps to O)

retencao_na_fontenumber nullable

Retenção na Fonte / withholding (maps to P)

descricaostring nullable

Description (maps to Descricao)

tipo_documentointeger nullable

Document type ID (maps to tipodocs)

pre_enhancedboolean

Skip server-side digitalization (file already cleaned by /invoices/digitalize-image)

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 21 revisions of this API.