Servers Playground How we check Add a server Log in

Oblio MCP by usefulapi

Working · 573 ms

io.usefulapi/obliov1.6.0 Domain verified

Read Oblio clients, products and documents; create proformas, issue, collect and cancel invoices.

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://oblio.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

oblio_cancel_document Destructive

CANCEL an invoice, proforma or notice. A cancelled invoice stays in the series but is void; if it was already sent to e-Factura / SPV, check the SPV side as well. Needs confirm: true and the user's approval. Not retried. PUT /api/docs/<type>/cancel.

cifstring, required

CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.

typestring, required

invoice (factura), proforma or notice (aviz de insotire).

numberstring, required

Document number within the series, digits only (0055 and 55 are the same).

series_namestring, required

Document series name (from oblio_list_series), for example FCT.

confirmboolean

Must be true. Set it only after the user has confirmed this exact action in this conversation.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Oblio MCP by usefulapi MCP server | mcptry

Tools (18)

oblio_cancel_document

destructive

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
type*	string	invoice (factura), proforma or notice (aviz de insotire).
number*	string	Document number within the series, digits only (0055 and 55 are the same).
confirm	boolean	Must be true. Set it only after the user has confirmed this exact action in this conversation.
series_name*	string	Document series name (from oblio_list_series), for example FCT.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "cif",
    "series_name",
    "number"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "type": {
      "enum": [
        "invoice",
        "proforma",
        "notice"
      ],
      "type": "string",
      "description": "invoice (factura), proforma or notice (aviz de insotire)."
    },
    "number": {
      "type": "string",
      "pattern": "^\\d{1,12}$",
      "description": "Document number within the series, digits only (0055 and 55 are the same)."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true. Set it only after the user has confirmed this exact action in this conversation."
    },
    "series_name": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Document series name (from oblio_list_series), for example FCT."
    }
  }
}

oblio_collect_invoice

Record that an issued invoice was paid (receipt, bank order, card...). Changes the invoice's paid status and is not reversible from the API. Needs confirm: true and the user's approval of the amount. Not retried. PUT /api/docs/invoice/collect.

destructive

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
number*	string	Document number within the series, digits only (0055 and 55 are the same).
collect*	object
confirm	boolean	Must be true. Set it only after the user has confirmed this exact action in this conversation.
series_name*	string	Document series name (from oblio_list_series), for example FCT.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif",
    "series_name",
    "number",
    "collect"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "number": {
      "type": "string",
      "pattern": "^\\d{1,12}$",
      "description": "Document number within the series, digits only (0055 and 55 are the same)."
    },
    "collect": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "enum": [
            "Chitanta",
            "Bon fiscal",
            "Bon fiscal card",
            "Alta incasare numerar",
            "Ordin de plata",
            "Mandat postal",
            "Card",
            "CEC",
            "Bilet ordin",
            "Alta incasare banca",
            "Ramburs"
          ],
          "type": "string",
          "description": "How the payment was received."
        },
        "value": {
          "type": "number",
          "maximum": 1000000000,
          "description": "Amount collected (default: the invoice total).",
          "exclusiveMinimum": 0
        },
        "mentions": {
          "type": "string",
          "maxLength": 500
        },
        "issue_date": {
          "type": "string",
          "description": "Collection date yyyy-mm-dd (default today)."
        },
        "document_number": {
          "type": "string",
          "maxLength": 60,
          "description": "Payment document number (for example the bank order number); required unless type is Chitanta."
        },
        "receipt_series_name": {
          "type": "string",
          "maxLength": 40,
          "description": "Receipt series name; required when type is Chitanta."
        }
      }
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true. Set it only after the user has confirmed this exact action in this conversation."
    },
    "series_name": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Document series name (from oblio_list_series), for example FCT."
    }
  }
}

oblio_create_proforma

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.

destructive

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
client*	object
currency	string	Document currency (default "RON").
due_date	string	Due date yyyy-mm-dd.
language	string	Document language code from oblio_list_languages (default "RO").
mentions	string	Mentions printed on the document.
products*	array	1-200 lines: products/services (name + price) or discounts (name + discount).
precision

oblio_create_webhook

Subscribe an HTTPS endpoint to an Oblio event (stock changes, drafts/updates/cancellations of documents, collections). Oblio will POST account data to that URL, so only use an endpoint the user named and controls; it must answer 200 with the base64 of the X-Oblio-Request-Id header. Needs confirm: true. POST /api/webhooks.

destructive

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
topic*	string	The event to subscribe to.
confirm	boolean	Must be true. Set it only after the user has confirmed this exact action in this conversation.
endpoint*	string	HTTPS URL that receives the notifications.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif",
    "topic",
    "endpoint"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "topic": {
      "enum": [
        "stock",
        "Invoice/SaveDraft",
        "Proforma/SaveDraft",
        "Notice/SaveDraft",
        "TaxReceipt/SaveDraft",
        "Invoice/Update",
        "Proforma/Update",
        "Notice/Update",
        "Invoice/Cancel",
        "Proforma/Cancel",
        "Notice/Cancel",
        "TaxReceipt/Cancel",
        "Collect/Inserted"
      ],
      "type": "string",
      "description": "The event to subscribe to."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true. Set it only after the user has confirmed this exact action in this conversation."
    },
    "endpoint": {
      "type": "string",
      "format": "uri",
      "maxLength": 500,
      "description": "HTTPS URL that receives the notifications."
    }
  }
}

oblio_delete_webhook

Delete a webhook subscription by id (from oblio_list_webhooks). Needs confirm: true. DELETE /api/webhooks/{id}.

destructive

Argument	Type	Description
id*	string	Webhook id from oblio_list_webhooks.
confirm	boolean	Must be true. Set it only after the user has confirmed this exact action in this conversation.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^\\d{1,18}$",
      "description": "Webhook id from oblio_list_webhooks."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true. Set it only after the user has confirmed this exact action in this conversation."
    }
  }
}

oblio_get_document

One invoice, proforma or notice by series and number: type, series, number, link to the PDF and (invoices) the collections. GET /api/docs/<type>.

read-only

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
type*	string	invoice (factura), proforma or notice (aviz de insotire).
number*	string	Document number within the series, digits only (0055 and 55 are the same).
series_name*	string	Document series name (from oblio_list_series), for example FCT.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "cif",
    "series_name",
    "number"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "type": {
      "enum": [
        "invoice",
        "proforma",
        "notice"
      ],
      "type": "string",
      "description": "invoice (factura), proforma or notice (aviz de insotire)."
    },
    "number": {
      "type": "string",
      "pattern": "^\\d{1,12}$",
      "description": "Document number within the series, digits only (0055 and 55 are the same)."
    },
    "series_name": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Document series name (from oblio_list_series), for example FCT."
    }
  }
}

oblio_issue_invoice

ISSUE a real INVOICE. This is a legal fiscal document: it takes the next number in the series at once, there is no draft state, it cannot be edited, and it can only be cancelled afterwards (it may also be sent to ANAF e-Factura / SPV, automatically if the account is set up so). Needs confirm: true, an idempotency_key, and the user's explicit approval of the exact client, lines, totals and series. Optionally base it on a proforma or notice (reference_document), record the payment at once (collect) or set the delivery date. Not retried: if the reply is an error, look in Oblio before repeating. Oblio never e-mails the client from this tool. POST /api/docs/invoice.

destructive

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
client	object	The client. Required unless reference_document is given (then Oblio takes it from the referenced document).
collect	object	Record the payment together with the invoice.
confirm	boolean	Must be true. Set it only after the user has confirmed this exact action in this conversation.
currency	string	Document currency (default "RON").
due_date	string	Due date yyyy-mm-dd.

oblio_list_clients

Clients of a company, optionally filtered by name or client CIF. Up to 250 per page: pass next_offset as offset for the next page. GET /api/nomenclature/clients.

read-only

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
name	string	Client name to search.
offset	integer	Start position, a multiple of 250 (0 default); use next_offset from the previous reply.
client_cif	string	CIF of the client to find.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Client name to search."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Start position, a multiple of 250 (0 default); use next_offset from the previous reply."
    },
    "client_cif": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "CIF of the client to find."
    }
  }
}

oblio_list_companies

The companies (CIF, name, your access level) linked to the connected Oblio account. Good first call: every other tool needs a CIF from here. GET /api/nomenclature/companies.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

oblio_list_invoices

Invoices of a company with filters (series, number, dates, client, draft/canceled/collected), newest first by default. Optional products, collections and e-Factura (SPV) status per invoice. Pass next_offset as offset for the next page. GET /api/docs/invoice/list.

read-only

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
draft	boolean	true = only drafts, false = only issued.
number	string	Only this document number.
offset	integer	Start position (0 default); use next_offset from the previous reply.
canceled	boolean	true = only canceled, false = only not canceled.
order_by	string
collected	boolean	true = only collected (paid), false = only not collected.
order_dir	string
client_cif

oblio_list_languages

Foreign languages a company can issue documents in (code, name). GET /api/nomenclature/languages.

read-only

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    }
  }
}

oblio_list_management

Stock managements (gestiuni) of a company with their work point and type; works only when stock is enabled. GET /api/nomenclature/management.

read-only

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    }
  }
}

oblio_list_products

Products and services of a company with unit, price, VAT and (with stock) quantities. Up to 250 per page: pass next_offset as offset. GET /api/nomenclature/products.

read-only

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
code	string	Product code to find.
name	string	Product name to search.
offset	integer	Start position, a multiple of 250 (0 default); use next_offset from the previous reply.
management	string	Stock management to search in (see oblio_list_management).
work_station	string	Work point of that management.
include_unsalable	boolean	true = include products marked as not for sale.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "code": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Product code to find."
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Product name to search."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Start position, a multiple of 250 (0 default); use next_offset from the previous reply."
    },
    "management": {
      "type": "string",
      "maxLength": 100,
      "description": "Stock management to search in (see oblio_list_management)."
    },
    "work_station": {
      "type": "string",
      "maxLength": 100,
      "description": "Work point of that management."
    },
    "include_unsalable": {
      "type": "boolean",
      "description": "true = include products marked as not for sale."
    }
  }
}

oblio_list_series

Document series of a company (type Factura/Proforma/Aviz, name, start, next number, default). Use the name as series_name. GET /api/nomenclature/series.

read-only

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    }
  }
}

oblio_list_vat_rates

VAT rates (name, percent, default) of a company; use the name and percent on document lines. GET /api/nomenclature/vat_rates.

read-only

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    }
  }
}

oblio_list_webhooks

The webhook subscriptions of the account (id, CIF, topic, endpoint). GET /api/webhooks.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

oblio_restore_document

Restore a previously CANCELLED invoice, proforma or notice. Needs confirm: true and the user's approval. Not retried. PUT /api/docs/<type>/restore.

destructive

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
type*	string	invoice (factura), proforma or notice (aviz de insotire).
number*	string	Document number within the series, digits only (0055 and 55 are the same).
confirm	boolean	Must be true. Set it only after the user has confirmed this exact action in this conversation.
series_name*	string	Document series name (from oblio_list_series), for example FCT.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "cif",
    "series_name",
    "number"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "type": {
      "enum": [
        "invoice",
        "proforma",
        "notice"
      ],
      "type": "string",
      "description": "invoice (factura), proforma or notice (aviz de insotire)."
    },
    "number": {
      "type": "string",
      "pattern": "^\\d{1,12}$",
      "description": "Document number within the series, digits only (0055 and 55 are the same)."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true. Set it only after the user has confirmed this exact action in this conversation."
    },
    "series_name": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Document series name (from oblio_list_series), for example FCT."
    }
  }
}

oblio_send_einvoice_to_spv

SEND an issued invoice to ANAF e-Factura (SPV). Irreversible: a document accepted by ANAF cannot be withdrawn from this API. Needs confirm: true and the user's approval. Not retried: check the status with oblio_list_invoices (with_einvoice_status) before repeating. Returns text, sent and a code (-1 not sent, 2 errors, 0 processing, 1 sent). POST /api/docs/einvoice.

destructive

Argument	Type	Description
cif*	string	CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090.
number*	string	Document number within the series, digits only (0055 and 55 are the same).
confirm	boolean	Must be true. Set it only after the user has confirmed this exact action in this conversation.
series_name*	string	Document series name (from oblio_list_series), for example FCT.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif",
    "series_name",
    "number"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "number": {
      "type": "string",
      "pattern": "^\\d{1,12}$",
      "description": "Document number within the series, digits only (0055 and 55 are the same)."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true. Set it only after the user has confirmed this exact action in this conversation."
    },
    "series_name": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Document series name (from oblio_list_series), for example FCT."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif",
    "client",
    "series_name",
    "products"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "client": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "rc": {
          "type": "string",
          "maxLength": 60,
          "description": "Trade register number."
        },
        "cif": {
          "type": "string",
          "maxLength": 40,
          "description": "Company CIF or the person's CNP."
        },
        "bank": {
          "type": "string",
          "maxLength": 100
        },
        "city": {
          "type": "string",
          "maxLength": 100
        },
        "code": {
          "type": "string",
          "maxLength": 60,
          "description": "Your client code."
        },
        "iban": {
          "type": "string",
          "maxLength": 60
        },
        "name": {
          "type": "string",
          "maxLength": 255,
          "minLength": 1,
          "description": "Client name (person) or company name."
        },
        "save": {
          "type": "boolean",
          "description": "true = update this client's saved data in Oblio. Default false (the document uses the data, the client record is not changed)."
        },
        "email": {
          "type": "string",
          "maxLength": 254
        },
        "phone": {
          "type": "string",
          "maxLength": 40
        },
        "state": {
          "type": "string",
          "maxLength": 100,
          "description": "County (judet)."
        },
        "address": {
          "type": "string",
          "maxLength": 500
        },
        "contact": {
          "type": "string",
          "maxLength": 200,
          "description": "Contact person."
        },
        "country": {
          "type": "string",
          "maxLength": 100
        },
        "vat_payer": {
          "type": "boolean",
          "description": "Whether the client is a VAT payer."
        },
        "autocomplete": {
          "type": "boolean",
          "description": "true = fill the data of a Romanian company from its CIF automatically."
        }
      }
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Document currency (default \"RON\")."
    },
    "due_date": {
      "type": "string",
      "description": "Due date yyyy-mm-dd."
    },
    "language": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Document language code from oblio_list_languages (default \"RO\")."
    },
    "mentions": {
      "type": "string",
      "maxLength": 2000,
      "description": "Mentions printed on the document."
    },
    "products": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "name",
              "price"
            ],
            "properties": {
              "code": {
                "type": "string",
                "maxLength": 60,
                "description": "Product code."
              },
              "name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1
              },
              "price": {
                "type": "number",
                "maximum": 1000000000,
                "minimum": -1000000000,
                "description": "Unit price."
              },
              "currency": {
                "type": "string",
                "pattern": "^[A-Za-z]{3}$",
                "description": "Currency of the line when it differs from the document's."
              },
              "quantity": {
                "type": "number",
                "maximum": 1000000000,
                "description": "Quantity (default 1).",
                "exclusiveMinimum": 0
              },
              "vat_name": {
                "type": "string",
                "maxLength": 60,
                "description": "VAT rate name from oblio_list_vat_rates, for example \"Normala\"."
              },
              "management": {
                "type": "string",
                "maxLength": 100,
                "description": "Stock management name (only with stock enabled, not for services)."
              },
              "save_price": {
                "type": "boolean",
                "description": "true = also store this price as the product's list price in Oblio. Default false."
              },
              "description": {
                "type": "string",
                "maxLength": 2000
              },
              "product_type": {
                "enum": [
                  "Marfa",
                  "Materii prime",
                  "Materiale consumabile",
                  "Semifabricate",
                  "Produs finit",
                  "Produs rezidual",
                  "Produse agricole",
                  "Animale si pasari",
                  "Ambalaje",
                  "Obiecte de inventar",
                  "Serviciu"
                ],
                "type": "string"
              },
              "vat_included": {
                "type": "boolean",
                "description": "true (default) = price already includes VAT."
              },
              "exchange_rate": {
                "type": "number",
                "maximum": 1000000,
                "exclusiveMinimum": 0
              },
              "measuring_unit": {
                "type": "string",
                "maxLength": 30,
                "description": "Unit of measure (default \"buc\")."
              },
              "vat_percentage": {
                "type": "number",
                "maximum": 100,
                "minimum": 0,
                "description": "VAT percentage from oblio_list_vat_rates, for example 19."
              }
            }
          },
          {
            "type": "object",
            "required": [
              "name",
              "discount"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1,
                "description": "Text shown next to the discount."
              },
              "discount": {
                "type": "number",
                "maximum": 1000000000,
                "minimum": 0,
                "description": "Discount value."
              },
              "discount_type": {
                "enum": [
                  "procentual",
                  "valoric"
                ],
                "type": "string",
                "description": "procentual (percent) or valoric (amount, default)."
              },
              "discount_all_above": {
                "type": "boolean",
                "description": "true = applies to all lines above that have no discount yet; false (default) = only the line directly above."
              }
            }
          }
        ]
      },
      "maxItems": 200,
      "minItems": 1,
      "description": "1-200 lines: products/services (name + price) or discounts (name + discount)."
    },
    "precision": {
      "type": "integer",
      "maximum": 4,
      "minimum": 2,
      "description": "Decimals, 2 to 4 (default 2)."
    },
    "issue_date": {
      "type": "string",
      "description": "Issue date yyyy-mm-dd (default today)."
    },
    "issuer_name": {
      "type": "string",
      "maxLength": 100,
      "description": "Prepared by (intocmit de)."
    },
    "series_name": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Document series name (from oblio_list_series), for example FCT."
    },
    "order_number": {
      "type": "string",
      "maxLength": 100,
      "description": "Order number (BT-13)."
    },
    "work_station": {
      "type": "string",
      "maxLength": 100,
      "description": "Work point (only with stock enabled; default \"Sediu\")."
    },
    "exchange_rate": {
      "type": "number",
      "maximum": 1000000,
      "description": "Exchange rate for a foreign-currency document (default: the company's setting).",
      "exclusiveMinimum": 0
    },
    "internal_note": {
      "type": "string",
      "maxLength": 1000,
      "description": "Internal note, not visible to the client."
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]+$",
      "maxLength": 64,
      "minLength": 8,
      "description": "Unique key so Oblio drops a duplicate of the same request."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif",
    "series_name",
    "idempotency_key"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "client": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "rc": {
          "type": "string",
          "maxLength": 60,
          "description": "Trade register number."
        },
        "cif": {
          "type": "string",
          "maxLength": 40,
          "description": "Company CIF or the person's CNP."
        },
        "bank": {
          "type": "string",
          "maxLength": 100
        },
        "city": {
          "type": "string",
          "maxLength": 100
        },
        "code": {
          "type": "string",
          "maxLength": 60,
          "description": "Your client code."
        },
        "iban": {
          "type": "string",
          "maxLength": 60
        },
        "name": {
          "type": "string",
          "maxLength": 255,
          "minLength": 1,
          "description": "Client name (person) or company name."
        },
        "save": {
          "type": "boolean",
          "description": "true = update this client's saved data in Oblio. Default false (the document uses the data, the client record is not changed)."
        },
        "email": {
          "type": "string",
          "maxLength": 254
        },
        "phone": {
          "type": "string",
          "maxLength": 40
        },
        "state": {
          "type": "string",
          "maxLength": 100,
          "description": "County (judet)."
        },
        "address": {
          "type": "string",
          "maxLength": 500
        },
        "contact": {
          "type": "string",
          "maxLength": 200,
          "description": "Contact person."
        },
        "country": {
          "type": "string",
          "maxLength": 100
        },
        "vat_payer": {
          "type": "boolean",
          "description": "Whether the client is a VAT payer."
        },
        "autocomplete": {
          "type": "boolean",
          "description": "true = fill the data of a Romanian company from its CIF automatically."
        }
      },
      "description": "The client. Required unless reference_document is given (then Oblio takes it from the referenced document)."
    },
    "collect": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "enum": [
            "Chitanta",
            "Bon fiscal",
            "Bon fiscal card",
            "Alta incasare numerar",
            "Ordin de plata",
            "Mandat postal",
            "Card",
            "CEC",
            "Bilet ordin",
            "Alta incasare banca",
            "Ramburs"
          ],
          "type": "string",
          "description": "How the payment was received."
        },
        "value": {
          "type": "number",
          "maximum": 1000000000,
          "description": "Amount collected (default: the invoice total).",
          "exclusiveMinimum": 0
        },
        "mentions": {
          "type": "string",
          "maxLength": 500
        },
        "issue_date": {
          "type": "string",
          "description": "Collection date yyyy-mm-dd (default today)."
        },
        "document_number": {
          "type": "string",
          "maxLength": 60,
          "description": "Payment document number (for example the bank order number); required unless type is Chitanta."
        },
        "receipt_series_name": {
          "type": "string",
          "maxLength": 40,
          "description": "Receipt series name; required when type is Chitanta."
        }
      },
      "description": "Record the payment together with the invoice."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true. Set it only after the user has confirmed this exact action in this conversation."
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Document currency (default \"RON\")."
    },
    "due_date": {
      "type": "string",
      "description": "Due date yyyy-mm-dd."
    },
    "language": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Document language code from oblio_list_languages (default \"RO\")."
    },
    "mentions": {
      "type": "string",
      "maxLength": 2000,
      "description": "Mentions printed on the document."
    },
    "products": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "name",
              "price"
            ],
            "properties": {
              "code": {
                "type": "string",
                "maxLength": 60,
                "description": "Product code."
              },
              "name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1
              },
              "price": {
                "type": "number",
                "maximum": 1000000000,
                "minimum": -1000000000,
                "description": "Unit price."
              },
              "currency": {
                "type": "string",
                "pattern": "^[A-Za-z]{3}$",
                "description": "Currency of the line when it differs from the document's."
              },
              "quantity": {
                "type": "number",
                "maximum": 1000000000,
                "description": "Quantity (default 1).",
                "exclusiveMinimum": 0
              },
              "vat_name": {
                "type": "string",
                "maxLength": 60,
                "description": "VAT rate name from oblio_list_vat_rates, for example \"Normala\"."
              },
              "management": {
                "type": "string",
                "maxLength": 100,
                "description": "Stock management name (only with stock enabled, not for services)."
              },
              "save_price": {
                "type": "boolean",
                "description": "true = also store this price as the product's list price in Oblio. Default false."
              },
              "description": {
                "type": "string",
                "maxLength": 2000
              },
              "product_type": {
                "enum": [
                  "Marfa",
                  "Materii prime",
                  "Materiale consumabile",
                  "Semifabricate",
                  "Produs finit",
                  "Produs rezidual",
                  "Produse agricole",
                  "Animale si pasari",
                  "Ambalaje",
                  "Obiecte de inventar",
                  "Serviciu"
                ],
                "type": "string"
              },
              "vat_included": {
                "type": "boolean",
                "description": "true (default) = price already includes VAT."
              },
              "exchange_rate": {
                "type": "number",
                "maximum": 1000000,
                "exclusiveMinimum": 0
              },
              "measuring_unit": {
                "type": "string",
                "maxLength": 30,
                "description": "Unit of measure (default \"buc\")."
              },
              "vat_percentage": {
                "type": "number",
                "maximum": 100,
                "minimum": 0,
                "description": "VAT percentage from oblio_list_vat_rates, for example 19."
              }
            }
          },
          {
            "type": "object",
            "required": [
              "name",
              "discount"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1,
                "description": "Text shown next to the discount."
              },
              "discount": {
                "type": "number",
                "maximum": 1000000000,
                "minimum": 0,
                "description": "Discount value."
              },
              "discount_type": {
                "enum": [
                  "procentual",
                  "valoric"
                ],
                "type": "string",
                "description": "procentual (percent) or valoric (amount, default)."
              },
              "discount_all_above": {
                "type": "boolean",
                "description": "true = applies to all lines above that have no discount yet; false (default) = only the line directly above."
              }
            }
          }
        ]
      },
      "maxItems": 200,
      "minItems": 1,
      "description": "1-200 lines: products/services (name + price) or discounts (name + discount). Required unless reference_document is given."
    },
    "precision": {
      "type": "integer",
      "maximum": 4,
      "minimum": 2,
      "description": "Decimals, 2 to 4 (default 2)."
    },
    "use_stock": {
      "type": "boolean",
      "description": "Take the goods out of stock (only with stock enabled)."
    },
    "issue_date": {
      "type": "string",
      "description": "Issue date yyyy-mm-dd (default today)."
    },
    "issuer_name": {
      "type": "string",
      "maxLength": 100,
      "description": "Prepared by (intocmit de)."
    },
    "series_name": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Document series name (from oblio_list_series), for example FCT."
    },
    "collect_date": {
      "type": "string",
      "description": "Collection date yyyy-mm-dd."
    },
    "order_number": {
      "type": "string",
      "maxLength": 100,
      "description": "Order number (BT-13)."
    },
    "work_station": {
      "type": "string",
      "maxLength": 100,
      "description": "Work point (only with stock enabled; default \"Sediu\")."
    },
    "delivery_date": {
      "type": "string",
      "description": "Delivery date yyyy-mm-dd."
    },
    "exchange_rate": {
      "type": "number",
      "maximum": 1000000,
      "description": "Exchange rate for a foreign-currency document (default: the company's setting).",
      "exclusiveMinimum": 0
    },
    "internal_note": {
      "type": "string",
      "maxLength": 1000,
      "description": "Internal note, not visible to the client."
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]+$",
      "maxLength": 64,
      "minLength": 8,
      "description": "REQUIRED unique key for this invoice (for example a UUID) so Oblio drops a duplicate of the same request."
    },
    "reference_document": {
      "type": "object",
      "required": [
        "type",
        "series_name",
        "number"
      ],
      "properties": {
        "type": {
          "enum": [
            "Factura",
            "Proforma",
            "Aviz"
          ],
          "type": "string",
          "description": "Type of the document this invoice is based on."
        },
        "number": {
          "type": "string",
          "pattern": "^\\d{1,12}$",
          "description": "Document number within the series, digits only (0055 and 55 are the same)."
        },
        "refund": {
          "type": "boolean",
          "description": "For a Factura reference (storno): also delete the collection tied to the reversed invoice."
        },
        "series_name": {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      },
      "description": "Base the invoice on a proforma or notice, or reverse an invoice."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cif"
  ],
  "properties": {
    "cif": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,20}$",
      "description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
    },
    "draft": {
      "type": "boolean",
      "description": "true = only drafts, false = only issued."
    },
    "number": {
      "type": "string",
      "pattern": "^\\d{1,12}$",
      "description": "Only this document number."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Start position (0 default); use next_offset from the previous reply."
    },
    "canceled": {
      "type": "boolean",
      "description": "true = only canceled, false = only not canceled."
    },
    "order_by": {
      "enum": [
        "id",
        "issueDate",
        "number"
      ],
      "type": "string"
    },
    "collected": {
      "type": "boolean",
      "description": "true = only collected (paid), false = only not collected."
    },
    "order_dir": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string"
    },
    "client_cif": {
      "type": "string",
      "maxLength": 40,
      "description": "Only invoices of the client with this CIF."
    },
    "client_code": {
      "type": "string",
      "maxLength": 60,
      "description": "Only invoices of the client with this code."
    },
    "series_name": {
      "type": "string",
      "maxLength": 40,
      "description": "Only this series."
    },
    "client_email": {
      "type": "string",
      "maxLength": 254,
      "description": "Only invoices of the client with this e-mail."
    },
    "issued_after": {
      "type": "string",
      "description": "Issued on or after yyyy-mm-dd."
    },
    "issued_before": {
      "type": "string",
      "description": "Issued on or before yyyy-mm-dd."
    },
    "with_collects": {
      "type": "boolean",
      "description": "Include the collections."
    },
    "with_products": {
      "type": "boolean",
      "description": "Include the invoice lines."
    },
    "limit_per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 100)."
    },
    "with_einvoice_status": {
      "type": "boolean",
      "description": "Include the e-Factura (SPV) status."
    }
  }
}