Oblio MCP by usefulapi
Read Oblio clients, products and documents; create proformas, issue, collect and cancel invoices.
使うべきか
品質と安全性
A
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~7,419トークン数（ツール定義）
~3.8 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 5.80%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"oblio": {
"url": "https://oblio.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://oblio.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール（18）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢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.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oblio_list_vat_rates(cif)
VAT rates (name, percent, default) of a company; use the name and percent on document lines. GET /api/nomenclature/vat_rates.
入力スキーマ
{
"type": "object",
"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."
}
},
"required": [
"cif"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oblio_list_series(cif)
Document series of a company (type Factura/Proforma/Aviz, name, start, next number, default). Use the name as series_name. GET /api/nomenclature/series.
入力スキーマ
{
"type": "object",
"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."
}
},
"required": [
"cif"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oblio_list_languages(cif)
Foreign languages a company can issue documents in (code, name). GET /api/nomenclature/languages.
入力スキーマ
{
"type": "object",
"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."
}
},
"required": [
"cif"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oblio_list_management(cif)
Stock managements (gestiuni) of a company with their work point and type; works only when stock is enabled. GET /api/nomenclature/management.
入力スキーマ
{
"type": "object",
"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."
}
},
"required": [
"cif"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oblio_list_clients(cif, name, client_cif, offset)
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.
入力スキーマ
{
"type": "object",
"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": {
"description": "Client name to search.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"client_cif": {
"description": "CIF of the client to find.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"offset": {
"description": "Start position, a multiple of 250 (0 default); use next_offset from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"cif"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oblio_list_products(cif, name, code, management, work_station, ...)
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.
入力スキーマ
{
"type": "object",
"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": {
"description": "Product name to search.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"code": {
"description": "Product code to find.",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"management": {
"description": "Stock management to search in (see oblio_list_management).",
"type": "string",
"maxLength": 100
},
"work_station": {
"description": "Work point of that management.",
"type": "string",
"maxLength": 100
},
"include_unsalable": {
"description": "true = include products marked as not for sale.",
"type": "boolean"
},
"offset": {
"description": "Start position, a multiple of 250 (0 default); use next_offset from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"cif"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oblio_get_document(type, cif, series_name, number)
One invoice, proforma or notice by series and number: type, series, number, link to the PDF and (invoices) the collections. GET /api/docs/<type>.
入力スキーマ
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"invoice",
"proforma",
"notice"
],
"description": "invoice (factura), proforma or notice (aviz de insotire)."
},
"cif": {
"type": "string",
"pattern": "^[A-Za-z0-9]{2,20}$",
"description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
},
"series_name": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Document series name (from oblio_list_series), for example FCT."
},
"number": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "Document number within the series, digits only (0055 and 55 are the same)."
}
},
"required": [
"type",
"cif",
"series_name",
"number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oblio_list_invoices(cif, series_name, number, client_cif, client_email, ...)
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.
入力スキーマ
{
"type": "object",
"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."
},
"series_name": {
"description": "Only this series.",
"type": "string",
"maxLength": 40
},
"number": {
"description": "Only this document number.",
"type": "string",
"pattern": "^\\d{1,12}$"
},
"client_cif": {
"description": "Only invoices of the client with this CIF.",
"type": "string",
"maxLength": 40
},
"client_email": {
"description": "Only invoices of the client with this e-mail.",
"type": "string",
"maxLength": 254
},
"client_code": {
"description": "Only invoices of the client with this code.",
"type": "string",
"maxLength": 60
},
"issued_after": {
"description": "Issued on or after yyyy-mm-dd.",
"type": "string"
},
"issued_before": {
"description": "Issued on or before yyyy-mm-dd.",
"type": "string"
},
"canceled": {
"description": "true = only canceled, false = only not canceled.",
"type": "boolean"
},
"collected": {
"description": "true = only collected (paid), false = only not collected.",
"type": "boolean"
},
"draft": {
"description": "true = only drafts, false = only issued.",
"type": "boolean"
},
"with_products": {
"description": "Include the invoice lines.",
"type": "boolean"
},
"with_collects": {
"description": "Include the collections.",
"type": "boolean"
},
"with_einvoice_status": {
"description": "Include the e-Factura (SPV) status.",
"type": "boolean"
},
"order_by": {
"type": "string",
"enum": [
"id",
"issueDate",
"number"
]
},
"order_dir": {
"type": "string",
"enum": [
"ASC",
"DESC"
]
},
"limit_per_page": {
"description": "Results per page, 1-100 (default 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Start position (0 default); use next_offset from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"cif"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢oblio_list_webhooks
The webhook subscriptions of the account (id, CIF, topic, endpoint). GET /api/webhooks.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oblio_create_proforma(cif, client, series_name, products, issue_date, ...)
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.
入力スキーマ
{
"type": "object",
"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",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Client name (person) or company name."
},
"cif": {
"description": "Company CIF or the person's CNP.",
"type": "string",
"maxLength": 40
},
"rc": {
"description": "Trade register number.",
"type": "string",
"maxLength": 60
},
"code": {
"description": "Your client code.",
"type": "string",
"maxLength": 60
},
"address": {
"type": "string",
"maxLength": 500
},
"state": {
"description": "County (judet).",
"type": "string",
"maxLength": 100
},
"city": {
"type": "string",
"maxLength": 100
},
"country": {
"type": "string",
"maxLength": 100
},
"iban": {
"type": "string",
"maxLength": 60
},
"bank": {
"type": "string",
"maxLength": 100
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"contact": {
"description": "Contact person.",
"type": "string",
"maxLength": 200
},
"vat_payer": {
"description": "Whether the client is a VAT payer.",
"type": "boolean"
},
"save": {
"description": "true = update this client's saved data in Oblio. Default false (the document uses the data, the client record is not changed).",
"type": "boolean"
},
"autocomplete": {
"description": "true = fill the data of a Romanian company from its CIF automatically.",
"type": "boolean"
}
},
"required": [
"name"
]
},
"series_name": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Document series name (from oblio_list_series), for example FCT."
},
"products": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255
},
"price": {
"type": "number",
"minimum": -1000000000,
"maximum": 1000000000,
"description": "Unit price."
},
"code": {
"description": "Product code.",
"type": "string",
"maxLength": 60
},
"description": {
"type": "string",
"maxLength": 2000
},
"measuring_unit": {
"description": "Unit of measure (default \"buc\").",
"type": "string",
"maxLength": 30
},
"currency": {
"description": "Currency of the line when it differs from the document's.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"exchange_rate": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"vat_name": {
"description": "VAT rate name from oblio_list_vat_rates, for example \"Normala\".",
"type": "string",
"maxLength": 60
},
"vat_percentage": {
"description": "VAT percentage from oblio_list_vat_rates, for example 19.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"vat_included": {
"description": "true (default) = price already includes VAT.",
"type": "boolean"
},
"quantity": {
"description": "Quantity (default 1).",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
},
"product_type": {
"type": "string",
"enum": [
"Marfa",
"Materii prime",
"Materiale consumabile",
"Semifabricate",
"Produs finit",
"Produs rezidual",
"Produse agricole",
"Animale si pasari",
"Ambalaje",
"Obiecte de inventar",
"Serviciu"
]
},
"management": {
"description": "Stock management name (only with stock enabled, not for services).",
"type": "string",
"maxLength": 100
},
"save_price": {
"description": "true = also store this price as the product's list price in Oblio. Default false.",
"type": "boolean"
}
},
"required": [
"name",
"price"
]
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Text shown next to the discount."
},
"discount": {
"type": "number",
"minimum": 0,
"maximum": 1000000000,
"description": "Discount value."
},
"discount_type": {
"description": "procentual (percent) or valoric (amount, default).",
"type": "string",
"enum": [
"procentual",
"valoric"
]
},
"discount_all_above": {
"description": "true = applies to all lines above that have no discount yet; false (default) = only the line directly above.",
"type": "boolean"
}
},
"required": [
"name",
"discount"
]
}
]
},
"description": "1-200 lines: products/services (name + price) or discounts (name + discount)."
},
"issue_date": {
"description": "Issue date yyyy-mm-dd (default today).",
"type": "string"
},
"due_date": {
"description": "Due date yyyy-mm-dd.",
"type": "string"
},
"language": {
"description": "Document language code from oblio_list_languages (default \"RO\").",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"currency": {
"description": "Document currency (default \"RON\").",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"exchange_rate": {
"description": "Exchange rate for a foreign-currency document (default: the company's setting).",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"precision": {
"description": "Decimals, 2 to 4 (default 2).",
"type": "integer",
"minimum": 2,
"maximum": 4
},
"issuer_name": {
"description": "Prepared by (intocmit de).",
"type": "string",
"maxLength": 100
},
"internal_note": {
"description": "Internal note, not visible to the client.",
"type": "string",
"maxLength": 1000
},
"mentions": {
"description": "Mentions printed on the document.",
"type": "string",
"maxLength": 2000
},
"order_number": {
"description": "Order number (BT-13).",
"type": "string",
"maxLength": 100
},
"work_station": {
"description": "Work point (only with stock enabled; default \"Sediu\").",
"type": "string",
"maxLength": 100
},
"idempotency_key": {
"description": "Unique key so Oblio drops a duplicate of the same request.",
"type": "string",
"minLength": 8,
"maxLength": 64,
"pattern": "^[A-Za-z0-9._:-]+$"
}
},
"required": [
"cif",
"client",
"series_name",
"products"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oblio_issue_invoice(cif, client, series_name, products, issue_date, ...)
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.
入力スキーマ
{
"type": "object",
"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": {
"description": "The client. Required unless reference_document is given (then Oblio takes it from the referenced document).",
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Client name (person) or company name."
},
"cif": {
"description": "Company CIF or the person's CNP.",
"type": "string",
"maxLength": 40
},
"rc": {
"description": "Trade register number.",
"type": "string",
"maxLength": 60
},
"code": {
"description": "Your client code.",
"type": "string",
"maxLength": 60
},
"address": {
"type": "string",
"maxLength": 500
},
"state": {
"description": "County (judet).",
"type": "string",
"maxLength": 100
},
"city": {
"type": "string",
"maxLength": 100
},
"country": {
"type": "string",
"maxLength": 100
},
"iban": {
"type": "string",
"maxLength": 60
},
"bank": {
"type": "string",
"maxLength": 100
},
"email": {
"type": "string",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 40
},
"contact": {
"description": "Contact person.",
"type": "string",
"maxLength": 200
},
"vat_payer": {
"description": "Whether the client is a VAT payer.",
"type": "boolean"
},
"save": {
"description": "true = update this client's saved data in Oblio. Default false (the document uses the data, the client record is not changed).",
"type": "boolean"
},
"autocomplete": {
"description": "true = fill the data of a Romanian company from its CIF automatically.",
"type": "boolean"
}
},
"required": [
"name"
]
},
"series_name": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Document series name (from oblio_list_series), for example FCT."
},
"products": {
"description": "1-200 lines: products/services (name + price) or discounts (name + discount). Required unless reference_document is given.",
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255
},
"price": {
"type": "number",
"minimum": -1000000000,
"maximum": 1000000000,
"description": "Unit price."
},
"code": {
"description": "Product code.",
"type": "string",
"maxLength": 60
},
"description": {
"type": "string",
"maxLength": 2000
},
"measuring_unit": {
"description": "Unit of measure (default \"buc\").",
"type": "string",
"maxLength": 30
},
"currency": {
"description": "Currency of the line when it differs from the document's.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"exchange_rate": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"vat_name": {
"description": "VAT rate name from oblio_list_vat_rates, for example \"Normala\".",
"type": "string",
"maxLength": 60
},
"vat_percentage": {
"description": "VAT percentage from oblio_list_vat_rates, for example 19.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"vat_included": {
"description": "true (default) = price already includes VAT.",
"type": "boolean"
},
"quantity": {
"description": "Quantity (default 1).",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
},
"product_type": {
"type": "string",
"enum": [
"Marfa",
"Materii prime",
"Materiale consumabile",
"Semifabricate",
"Produs finit",
"Produs rezidual",
"Produse agricole",
"Animale si pasari",
"Ambalaje",
"Obiecte de inventar",
"Serviciu"
]
},
"management": {
"description": "Stock management name (only with stock enabled, not for services).",
"type": "string",
"maxLength": 100
},
"save_price": {
"description": "true = also store this price as the product's list price in Oblio. Default false.",
"type": "boolean"
}
},
"required": [
"name",
"price"
]
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Text shown next to the discount."
},
"discount": {
"type": "number",
"minimum": 0,
"maximum": 1000000000,
"description": "Discount value."
},
"discount_type": {
"description": "procentual (percent) or valoric (amount, default).",
"type": "string",
"enum": [
"procentual",
"valoric"
]
},
"discount_all_above": {
"description": "true = applies to all lines above that have no discount yet; false (default) = only the line directly above.",
"type": "boolean"
}
},
"required": [
"name",
"discount"
]
}
]
}
},
"issue_date": {
"description": "Issue date yyyy-mm-dd (default today).",
"type": "string"
},
"due_date": {
"description": "Due date yyyy-mm-dd.",
"type": "string"
},
"language": {
"description": "Document language code from oblio_list_languages (default \"RO\").",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"currency": {
"description": "Document currency (default \"RON\").",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"exchange_rate": {
"description": "Exchange rate for a foreign-currency document (default: the company's setting).",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"precision": {
"description": "Decimals, 2 to 4 (default 2).",
"type": "integer",
"minimum": 2,
"maximum": 4
},
"issuer_name": {
"description": "Prepared by (intocmit de).",
"type": "string",
"maxLength": 100
},
"internal_note": {
"description": "Internal note, not visible to the client.",
"type": "string",
"maxLength": 1000
},
"mentions": {
"description": "Mentions printed on the document.",
"type": "string",
"maxLength": 2000
},
"order_number": {
"description": "Order number (BT-13).",
"type": "string",
"maxLength": 100
},
"work_station": {
"description": "Work point (only with stock enabled; default \"Sediu\").",
"type": "string",
"maxLength": 100
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 64,
"pattern": "^[A-Za-z0-9._:-]+$",
"description": "REQUIRED unique key for this invoice (for example a UUID) so Oblio drops a duplicate of the same request."
},
"delivery_date": {
"description": "Delivery date yyyy-mm-dd.",
"type": "string"
},
"collect_date": {
"description": "Collection date yyyy-mm-dd.",
"type": "string"
},
"reference_document": {
"description": "Base the invoice on a proforma or notice, or reverse an invoice.",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"Factura",
"Proforma",
"Aviz"
],
"description": "Type of the document this invoice is based on."
},
"series_name": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"number": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "Document number within the series, digits only (0055 and 55 are the same)."
},
"refund": {
"description": "For a Factura reference (storno): also delete the collection tied to the reversed invoice.",
"type": "boolean"
}
},
"required": [
"type",
"series_name",
"number"
]
},
"collect": {
"description": "Record the payment together with the invoice.",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"Chitanta",
"Bon fiscal",
"Bon fiscal card",
"Alta incasare numerar",
"Ordin de plata",
"Mandat postal",
"Card",
"CEC",
"Bilet ordin",
"Alta incasare banca",
"Ramburs"
],
"description": "How the payment was received."
},
"receipt_series_name": {
"description": "Receipt series name; required when type is Chitanta.",
"type": "string",
"maxLength": 40
},
"document_number": {
"description": "Payment document number (for example the bank order number); required unless type is Chitanta.",
"type": "string",
"maxLength": 60
},
"value": {
"description": "Amount collected (default: the invoice total).",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
},
"issue_date": {
"description": "Collection date yyyy-mm-dd (default today).",
"type": "string"
},
"mentions": {
"type": "string",
"maxLength": 500
}
},
"required": [
"type"
]
},
"use_stock": {
"description": "Take the goods out of stock (only with stock enabled).",
"type": "boolean"
},
"confirm": {
"description": "Must be true. Set it only after the user has confirmed this exact action in this conversation.",
"type": "boolean"
}
},
"required": [
"cif",
"series_name",
"idempotency_key"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oblio_collect_invoice(cif, series_name, number, collect, confirm)
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.
入力スキーマ
{
"type": "object",
"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."
},
"series_name": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Document series name (from oblio_list_series), for example FCT."
},
"number": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "Document number within the series, digits only (0055 and 55 are the same)."
},
"collect": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"Chitanta",
"Bon fiscal",
"Bon fiscal card",
"Alta incasare numerar",
"Ordin de plata",
"Mandat postal",
"Card",
"CEC",
"Bilet ordin",
"Alta incasare banca",
"Ramburs"
],
"description": "How the payment was received."
},
"receipt_series_name": {
"description": "Receipt series name; required when type is Chitanta.",
"type": "string",
"maxLength": 40
},
"document_number": {
"description": "Payment document number (for example the bank order number); required unless type is Chitanta.",
"type": "string",
"maxLength": 60
},
"value": {
"description": "Amount collected (default: the invoice total).",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
},
"issue_date": {
"description": "Collection date yyyy-mm-dd (default today).",
"type": "string"
},
"mentions": {
"type": "string",
"maxLength": 500
}
},
"required": [
"type"
]
},
"confirm": {
"description": "Must be true. Set it only after the user has confirmed this exact action in this conversation.",
"type": "boolean"
}
},
"required": [
"cif",
"series_name",
"number",
"collect"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oblio_cancel_document(type, cif, series_name, number, confirm)
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.
入力スキーマ
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"invoice",
"proforma",
"notice"
],
"description": "invoice (factura), proforma or notice (aviz de insotire)."
},
"cif": {
"type": "string",
"pattern": "^[A-Za-z0-9]{2,20}$",
"description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
},
"series_name": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Document series name (from oblio_list_series), for example FCT."
},
"number": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "Document number within the series, digits only (0055 and 55 are the same)."
},
"confirm": {
"description": "Must be true. Set it only after the user has confirmed this exact action in this conversation.",
"type": "boolean"
}
},
"required": [
"type",
"cif",
"series_name",
"number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oblio_restore_document(type, cif, series_name, number, confirm)
Restore a previously CANCELLED invoice, proforma or notice. Needs confirm: true and the user's approval. Not retried. PUT /api/docs/<type>/restore.
入力スキーマ
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"invoice",
"proforma",
"notice"
],
"description": "invoice (factura), proforma or notice (aviz de insotire)."
},
"cif": {
"type": "string",
"pattern": "^[A-Za-z0-9]{2,20}$",
"description": "CIF of YOUR company in Oblio (from oblio_list_companies), for example RO37311090."
},
"series_name": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Document series name (from oblio_list_series), for example FCT."
},
"number": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "Document number within the series, digits only (0055 and 55 are the same)."
},
"confirm": {
"description": "Must be true. Set it only after the user has confirmed this exact action in this conversation.",
"type": "boolean"
}
},
"required": [
"type",
"cif",
"series_name",
"number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oblio_send_einvoice_to_spv(cif, series_name, number, confirm)
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.
入力スキーマ
{
"type": "object",
"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."
},
"series_name": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Document series name (from oblio_list_series), for example FCT."
},
"number": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "Document number within the series, digits only (0055 and 55 are the same)."
},
"confirm": {
"description": "Must be true. Set it only after the user has confirmed this exact action in this conversation.",
"type": "boolean"
}
},
"required": [
"cif",
"series_name",
"number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oblio_create_webhook(cif, topic, endpoint, confirm)
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.
入力スキーマ
{
"type": "object",
"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": {
"type": "string",
"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"
],
"description": "The event to subscribe to."
},
"endpoint": {
"type": "string",
"maxLength": 500,
"format": "uri",
"description": "HTTPS URL that receives the notifications."
},
"confirm": {
"description": "Must be true. Set it only after the user has confirmed this exact action in this conversation.",
"type": "boolean"
}
},
"required": [
"cif",
"topic",
"endpoint"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴oblio_delete_webhook(id, confirm)
Delete a webhook subscription by id (from oblio_list_webhooks). Needs confirm: true. DELETE /api/webhooks/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{1,18}$",
"description": "Webhook id from oblio_list_webhooks."
},
"confirm": {
"description": "Must be true. Set it only after the user has confirmed this exact action in this conversation.",
"type": "boolean"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 18 件