Create a proforma
oblio_create_proformaDestructive
Create a PROFORMA (not a fiscal invoice; the preferred first step). It takes the next number of the series immediately, there is no draft state, and Oblio sends no e-mail. Check client, lines, VAT (oblio_list_vat_rates) and series (oblio_list_series) first. Returns the series, number and a PDF link. Not retried: if the reply is an error, look in Oblio before repeating. POST /api/docs/proforma.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cif | Yes | CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090. | |
| client | Yes | ||
| currency | No | Document currency (default "RON"). | |
| due_date | No | Due date yyyy-mm-dd. | |
| language | No | Document language code from oblio_list_languages (default "RO"). | |
| mentions | No | Mentions printed on the document. | |
| products | Yes | 1-200 lines: products/services (name + price) or discounts (name + discount). | |
| precision | No | Decimals, 2 to 4 (default 2). | |
| issue_date | No | Issue date yyyy-mm-dd (default today). | |
| issuer_name | No | Prepared by (intocmit de). | |
| series_name | Yes | Document series name (from oblio_list_series), for example FCT. | |
| order_number | No | Order number (BT-13). | |
| work_station | No | Work point (only with stock enabled; default "Sediu"). | |
| exchange_rate | No | Exchange rate for a foreign-currency document (default: the company's setting). | |
| internal_note | No | Internal note, not visible to the client. | |
| idempotency_key | No | Unique key so Oblio drops a duplicate of the same request. |