Oblio MCP by usefulapi is an MCP server published by io.usefulapi, hosted at oblio.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 18 tools, including oblio_list_companies, oblio_list_vat_rates, oblio_list_series, oblio_list_languages, oblio_list_management.
Read Oblio clients, products and documents; create proformas, issue, collect and cancel invoices.
4,280 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
No parameters.
{
"name": "oblio_list_companies",
"title": "List companies",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List companies",
"readOnlyHint": true
}
}VAT rates (name, percent, default) of a company; use the name and percent on document lines. GET /api/nomenclature/vat_rates.
| Parameter | Type | Description |
|---|---|---|
| cif * | string | CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090. |
{
"name": "oblio_list_vat_rates",
"title": "List VAT rates",
"description": "VAT rates (name, percent, default) of a company; use the name and percent on document lines. GET /api/nomenclature/vat_rates.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List VAT rates",
"readOnlyHint": true
}
}Document series of a company (type Factura/Proforma/Aviz, name, start, next number, default). Use the name as series_name. GET /api/nomenclature/series.
| Parameter | Type | Description |
|---|---|---|
| cif * | string | CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090. |
{
"name": "oblio_list_series",
"title": "List document series",
"description": "Document series of a company (type Factura/Proforma/Aviz, name, start, next number, default). Use the name as series_name. GET /api/nomenclature/series.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List document series",
"readOnlyHint": true
}
}Foreign languages a company can issue documents in (code, name). GET /api/nomenclature/languages.
| Parameter | Type | Description |
|---|---|---|
| cif * | string | CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090. |
{
"name": "oblio_list_languages",
"title": "List document languages",
"description": "Foreign languages a company can issue documents in (code, name). GET /api/nomenclature/languages.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List document languages",
"readOnlyHint": true
}
}Stock managements (gestiuni) of a company with their work point and type; works only when stock is enabled. GET /api/nomenclature/management.
| Parameter | Type | Description |
|---|---|---|
| cif * | string | CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090. |
{
"name": "oblio_list_management",
"title": "List stock managements",
"description": "Stock managements (gestiuni) of a company with their work point and type; works only when stock is enabled. GET /api/nomenclature/management.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List stock managements",
"readOnlyHint": true
}
}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.
| Parameter | 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. |
{
"name": "oblio_list_clients",
"title": "List or search clients",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List or search clients",
"readOnlyHint": true
}
}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.
| Parameter | 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. |
{
"name": "oblio_list_products",
"title": "List or search products",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List or search products",
"readOnlyHint": true
}
}One invoice, proforma or notice by series and number: type, series, number, link to the PDF and (invoices) the collections. GET /api/docs/<type>.
| Parameter | 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. |
{
"name": "oblio_get_document",
"title": "Get a document",
"description": "One invoice, proforma or notice by series and number: type, series, number, link to the PDF and (invoices) the collections. GET /api/docs/<type>.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Get a document",
"readOnlyHint": true
}
}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.
| Parameter | 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 | one of ["id","issueDate","number"] |
| collected | boolean | true = only collected (paid), false = only not collected. |
| order_dir | string | one of ["ASC","DESC"] |
| client_cif | string | Only invoices of the client with this CIF. |
| client_code | string |
The webhook subscriptions of the account (id, CIF, topic, endpoint). GET /api/webhooks.
No parameters.
{
"name": "oblio_list_webhooks",
"title": "List webhooks",
"description": "The webhook subscriptions of the account (id, CIF, topic, endpoint). GET /api/webhooks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List webhooks",
"readOnlyHint": true
}
}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.
| Parameter | 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 | integer | Decimals, 2 to 4 (default 2). |
| issue_date | string |
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.
| Parameter | 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. |
| language | string | Document language code from oblio_list_languages (default "RO"). |
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.
| Parameter | 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. |
{
"name": "oblio_collect_invoice",
"title": "Record an invoice payment (collect)",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Record an invoice payment (collect)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | 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. |
{
"name": "oblio_cancel_document",
"title": "Cancel a document (fiscal)",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Cancel a document (fiscal)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Restore a previously CANCELLED invoice, proforma or notice. Needs confirm: true and the user's approval. Not retried. PUT /api/docs/<type>/restore.
| Parameter | 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. |
{
"name": "oblio_restore_document",
"title": "Restore a cancelled document (fiscal)",
"description": "Restore a previously CANCELLED invoice, proforma or notice. Needs confirm: true and the user's approval. Not retried. PUT /api/docs/<type>/restore.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Restore a cancelled document (fiscal)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | 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. |
{
"name": "oblio_send_einvoice_to_spv",
"title": "Send an invoice to e-Factura (SPV)",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Send an invoice to e-Factura (SPV)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | 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. |
{
"name": "oblio_create_webhook",
"title": "Create a webhook",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Create a webhook",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Delete a webhook subscription by id (from oblio_list_webhooks). Needs confirm: true. DELETE /api/webhooks/{id}.
| Parameter | 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. |
{
"name": "oblio_delete_webhook",
"title": "Delete a webhook",
"description": "Delete a webhook subscription by id (from oblio_list_webhooks). Needs confirm: true. DELETE /api/webhooks/{id}.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Delete a webhook",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Tools for Oblio, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which of my invoices from this month have not been collected yet?"; "Show invoices issued to client Acme SRL since January."; "Which document series do I have and what is the next number in each?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Oblio data. Free plan: 50 tool calls per month. Run oblio_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run oblio_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run oblio_upgrade without a plan: it returns both plans, each with a payment link for the user to open. oblio_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| Only invoices of the client with this code. |
| series_name | string | Only this series. |
| client_email | string | Only invoices of the client with this e-mail. |
| issued_after | string | Issued on or after yyyy-mm-dd. |
| issued_before | string | Issued on or before yyyy-mm-dd. |
| with_collects | boolean | Include the collections. |
| with_products | boolean | Include the invoice lines. |
| limit_per_page | integer | Results per page, 1-100 (default 100). |
| with_einvoice_status | boolean | Include the e-Factura (SPV) status. |
{
"name": "oblio_list_invoices",
"title": "List invoices",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true
}
}| Issue date yyyy-mm-dd (default today). |
| issuer_name | string | Prepared by (intocmit de). |
| series_name * | string | Document series name (from oblio_list_series), for example FCT. |
| order_number | string | Order number (BT-13). |
| work_station | string | Work point (only with stock enabled; default "Sediu"). |
| exchange_rate | number | Exchange rate for a foreign-currency document (default: the company's setting). |
| internal_note | string | Internal note, not visible to the client. |
| idempotency_key | string | Unique key so Oblio drops a duplicate of the same request. |
{
"name": "oblio_create_proforma",
"title": "Create a proforma",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Create a proforma",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| mentions | string | Mentions printed on the document. |
| products | array | 1-200 lines: products/services (name + price) or discounts (name + discount). Required unless reference_document is given. |
| precision | integer | Decimals, 2 to 4 (default 2). |
| use_stock | boolean | Take the goods out of stock (only with stock enabled). |
| issue_date | string | Issue date yyyy-mm-dd (default today). |
| issuer_name | string | Prepared by (intocmit de). |
| series_name * | string | Document series name (from oblio_list_series), for example FCT. |
| collect_date | string | Collection date yyyy-mm-dd. |
| order_number | string | Order number (BT-13). |
| work_station | string | Work point (only with stock enabled; default "Sediu"). |
| delivery_date | string | Delivery date yyyy-mm-dd. |
| exchange_rate | number | Exchange rate for a foreign-currency document (default: the company's setting). |
| internal_note | string | Internal note, not visible to the client. |
| idempotency_key * | string | REQUIRED unique key for this invoice (for example a UUID) so Oblio drops a duplicate of the same request. |
| reference_document | object | Base the invoice on a proforma or notice, or reverse an invoice. |
{
"name": "oblio_issue_invoice",
"title": "Issue an invoice (fiscal, irreversible)",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Issue an invoice (fiscal, irreversible)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}