Romania Invoices (ANAF e-Factura national API)

Official3 toolsLive

by junter1989k-ai · JavaScript

Romania e-Factura invoices for AI agents: build UBL 2.1 CIUS-RO, upload to ANAF/SPV, query.

Topics

ai-agentsanafe-facturae-invoiceinvoicingmcpmcp-serverromaniaublai-agentclaudeinvoicevatwishpool

Captured live from the server via tools/list.

create_invoice

Issue a Romania B2B electronic invoice (factura electronica) into the national e-Factura system (ANAF/SPV). Builds UBL 2.1 XML in the CIUS-RO customization (Romania's CIUS of EN 16931) and uploads it under your own ANAF access token. Bring your own credentials as headers: x-anaf-token (Bearer access token from your one-time ANAF OAuth with a qualified digital certificate; the cert never reaches this server), x-anaf-cif (your supplier fiscal code / CIF, RO prefix optional). Header x-anaf-mode: production switches to the live rail (default = test, no fiscal effect). Upload is asynchronous: this returns index_incarcare (an upload index) — poll query_invoice with it to learn if ANAF ACCEPTED or REJECTED the invoice. Romanian VAT rates: 19 (standard), 9 and 5 (reduced), 0 (zero-rated). Amounts are in RON.

Parameters15

customer_name	string	required	Buyer legal name (denumire) as registered.
customer_cif	string	required	Buyer fiscal code / CIF (cod de identificare fiscala), e.g. RO12345678 or 12345678. RO prefix optional.
customer_address	string	required	Buyer street address (BT-50 address line 1).
customer_city	string	optional	Buyer city (BT-52). Bucharest sectors use SECTOR1..SECTOR6. Default SECTOR1.
customer_county_code	string	optional	Buyer county subdivision ISO 3166-2 code (BT-54), e.g. RO-B (Bucharest), RO-CJ (Cluj). Default RO-B.
customer_country	string	optional	Buyer country code (BT-55). Default RO.
supplier_name	string	optional	Your (seller) legal name (BT-27). Recommended; a placeholder derived from your CIF is used if omitted.
supplier_address	string	optional	Your (seller) street address (BT-35). Recommended for a valid invoice.
supplier_city	string	optional	Your (seller) city (BT-37). Bucharest sectors use SECTOR1..SECTOR6.
supplier_county_code	string	optional	Your (seller) county ISO 3166-2 code (BT-39, CIUS-RO mandatory for RO sellers), e.g. RO-B. Default RO-B.
invoice_number	string	optional	Your invoice number / series (BT-1). Auto-generated if omitted.
issue_date	string	optional	Invoice issue date (BT-2), YYYY-MM-DD. Default: today (UTC).
due_date	string	optional	Optional payment due date (BT-9), YYYY-MM-DD.
currency	string	optional	Document currency (BT-5). Default RON.
lines	array	required	Invoice lines. Each: name, unit_price (net, VAT-exclusive, RON), vat_rate (19\|9\|5\|0), optional quantity (default 1) and unit_code (UN/ECE Rec 20, default C62 = piece).

Raw schema

{
  "type": "object",
  "properties": {
    "customer_name": {
      "type": "string",
      "description": "Buyer legal name (denumire) as registered."
    },
    "customer_cif": {
      "type": "string",
      "description": "Buyer fiscal code / CIF (cod de identificare fiscala), e.g. RO12345678 or 12345678. RO prefix optional."
    },
    "customer_address": {
      "type": "string",
      "description": "Buyer street address (BT-50 address line 1)."
    },
    "customer_city": {
      "type": "string",
      "description": "Buyer city (BT-52). Bucharest sectors use SECTOR1..SECTOR6. Default SECTOR1."
    },
    "customer_county_code": {
      "type": "string",
      "description": "Buyer county subdivision ISO 3166-2 code (BT-54), e.g. RO-B (Bucharest), RO-CJ (Cluj). Default RO-B."
    },
    "customer_country": {
      "type": "string",
      "description": "Buyer country code (BT-55). Default RO."
    },
    "supplier_name": {
      "type": "string",
      "description": "Your (seller) legal name (BT-27). Recommended; a placeholder derived from your CIF is used if omitted."
    },
    "supplier_address": {
      "type": "string",
      "description": "Your (seller) street address (BT-35). Recommended for a valid invoice."
    },
    "supplier_city": {
      "type": "string",
      "description": "Your (seller) city (BT-37). Bucharest sectors use SECTOR1..SECTOR6."
    },
    "supplier_county_code": {
      "type": "string",
      "description": "Your (seller) county ISO 3166-2 code (BT-39, CIUS-RO mandatory for RO sellers), e.g. RO-B. Default RO-B."
    },
    "invoice_number": {
      "type": "string",
      "description": "Your invoice number / series (BT-1). Auto-generated if omitted."
    },
    "issue_date": {
      "type": "string",
      "description": "Invoice issue date (BT-2), YYYY-MM-DD. Default: today (UTC)."
    },
    "due_date": {
      "type": "string",
      "description": "Optional payment due date (BT-9), YYYY-MM-DD."
    },
    "currency": {
      "type": "string",
      "description": "Document currency (BT-5). Default RON."
    },
    "lines": {
      "type": "array",
      "minItems": 1,
      "description": "Invoice lines. Each: name, unit_price (net, VAT-exclusive, RON), vat_rate (19|9|5|0), optional quantity (default 1) and unit_code (UN/ECE Rec 20, default C62 = piece).",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Item name/description (BT-153)."
          },
          "unit_price": {
            "type": "number",
            "description": "Net unit price in RON, VAT-exclusive (BT-146)."
          },
          "vat_rate": {
            "type": "number",
            "description": "VAT rate percent: 19 standard, 9 or 5 reduced, 0 zero-rated (BT-152)."
          },
          "quantity": {
            "type": "number",
            "description": "Quantity (BT-129). Default 1."
          },
          "unit_code": {
            "type": "string",
            "description": "Unit of measure UN/ECE Rec 20 code (BT-130). Default C62 (piece)."
          }
        },
        "required": [
          "name",
          "unit_price",
          "vat_rate"
        ]
      }
    }
  },
  "required": [
    "customer_name",
    "customer_cif",
    "customer_address",
    "lines"
  ]
}

query_invoice

Check the ANAF processing status of an invoice uploaded by create_invoice, using its index_incarcare. e-Factura processing is asynchronous. Status values: PROCESSING (ANAF stare "in prelucrare" — not finished, poll again shortly); ACCEPTED (stare "ok" — the invoice is registered; download_invoice_result fetches the official ANAF-signed XML using download_id); REJECTED (stare "nok" — validation failed; download_invoice_result fetches the error report XML using download_id). Safe to call anytime.

Parameters1

index_incarcare

string

required

The index_incarcare (upload index) returned by create_invoice.

Raw schema

{
  "type": "object",
  "properties": {
    "index_incarcare": {
      "type": "string",
      "description": "The index_incarcare (upload index) returned by create_invoice."
    }
  },
  "required": [
    "index_incarcare"
  ]
}

download_invoice_result

Download the ANAF response archive (ZIP) for a processed invoice, using the download_id (id_descarcare) that query_invoice returns once status is ACCEPTED or REJECTED. For ACCEPTED invoices the ZIP contains the official ANAF-signed UBL XML (your legal proof); for REJECTED invoices it contains an XML error report listing the CIUS-RO validation failures. Returns the ZIP base64-encoded. Safe to call anytime.

Parameters1

download_id

string

required

The download_id (id_descarcare) returned by query_invoice for an ACCEPTED or REJECTED invoice.

Raw schema

{
  "type": "object",
  "properties": {
    "download_id": {
      "type": "string",
      "description": "The download_id (id_descarcare) returned by query_invoice for an ACCEPTED or REJECTED invoice."
    }
  },
  "required": [
    "download_id"
  ]
}

README.md4 KBView on GitHub

Romania Invoice MCP 🇷🇴 — How can my AI agent issue an e-Factura factura electronica in Romania?

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "romania-invoice": {
      "type": "http",
      "url": "https://inv-ro.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/romania-invoice-mcp && cd romania-invoice-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Remote MCP server that lets any AI agent issue Romania e-Factura electronic invoices (factura electronica) into the national ANAF/SPV system. It builds UBL 2.1 CIUS-RO XML (Romania's CIUS of EN 16931) and uploads it under the merchant's own ANAF access token. Stateless, bring-your-own credentials, never stores anything.

Live endpoint: https://inv-ro.wishpool.app/mcp · Registry: app.wishpool/romania-invoice-mcp

Quick start

json

{
  "mcpServers": {
    "romania-invoice": {
      "type": "http",
      "url": "https://inv-ro.wishpool.app/mcp",
      "headers": {
        "x-anaf-token": "<your ANAF access token>",
        "x-anaf-cif": "RO12345678"
      }
    }
  }
}

You complete a one-time ANAF OAuth in your browser with your qualified digital certificate and hold the access token (~90 days) + refresh token (~365 days). Requests default to the ANAF test rail (no fiscal effect); add x-anaf-mode: production for the live rail. Your certificate never reaches this server.

Tools

Tool	What it does
`create_invoice`	Build a UBL 2.1 CIUS-RO invoice from customer CIF + name + address + lines (name, qty, net unit price, VAT rate 19/9/5/0) and upload to ANAF e-Factura. Returns `index_incarcare` + computed VAT totals.
`query_invoice`	Poll ANAF status by `index_incarcare`: `PROCESSING` (in prelucrare), `ACCEPTED` (ok), `REJECTED` (nok); returns `download_id` when finished.
`download_invoice_result`	Download the ANAF response ZIP (base64) by `download_id` — signed XML if accepted, error report if rejected.

Amounts are in RON. No cancel at API level — corrections are new invoices. Token refresh is out of scope in v1 (the merchant refreshes via their own ANAF OAuth app).

Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them.

Endpoints wrapped (ANAF e-Factura REST)

Base: TEST https://api.anaf.ro/test/FCTEL/rest · PROD https://api.anaf.ro/prod/FCTEL/rest
Upload: POST /upload?standard=UBL&cif={cif} (raw UBL XML body) → index_incarcare
Status: GET /stareMesaj?id_incarcare={index} → stare in prelucrare | ok | nok
Download: GET /descarcare?id={id_descarcare} → ZIP

Develop

bash

node test/serve.js   # local server on :3232
node test/e2e.js     # protocol + validation + VAT math + UBL structure + fake-token live probes

Safety

Pure stateless translation layer over the national ANAF e-Factura API. The qualified certificate and OAuth stay with the merchant; the access token travels per-request in a header, nothing is stored. Privacy policy.

Sister servers

Local invoices, one family: Mexico CFDI (inv-mx) · Brazil NF-e (inv-br) · Chile DTE (inv-cl) · Peru CPE (inv-pe) · India GST (inv-in). Local payments in 81 countries: mcp.wishpool.app.

MIT licensed.

Install

Tools (3)

create_invoicequery_invoicedownload_invoice_result

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://inv-ro.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "romania-invoice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://inv-ro.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.