colombia-invoice-mcp

Let AI agents issue Colombia DIAN electronic invoices through your own Matias API account — direct to DIAN with no technology-provider intermediary. Create invoices, query status by UUID. Stateless: bring your own token, IVA 19/5/0% computed locally, never stores data.

该来源不提供完整文件导出（国内平台多为平台内托管），仅存元数据与原链

接入信息

传输形态: http
鉴权方式: 鉴权未知
端点: https://colombia-invoice-mcp--wishpool.run.tools

鉴权方式未标注，请核对官方文档后再接入——不要直接使用以下片段

{
  "mcpServers": {
    "colombia-invoice-mcp": {
      "url": "https://colombia-invoice-mcp--wishpool.run.tools"
    }
  }
}

能力清单

工具

说明

create_invoice

Issue a Colombia electronic invoice (factura de venta / factura electrónica, DIAN UBL 2.1) through Matias API, which digitally signs it and transmits it straight to the DIAN (no Proveedor Tecnológico middleman) from YOUR OWN Matias account — this server only forwards the call and never holds your certificate. It wraps POST /invoice. Amounts are in Colombian pesos (COP, integer convention) and unit prices are TAX-EXCLUSIVE (valor neto, before IVA). IVA (VAT) rate per line: 19 (standard), 5 (reduced), or 0 (exento/excluido); the server liquidates the IVA locally (line net * rate/100) and builds the UBL totals. You must pass your DIAN resolution_number (from the resolución de facturación DIAN issued to your account) and the buyer. On success you get back the DIAN cufe (Código Único de Facturación Electrónica) and the acceptance state. Set x-matias-env=sandbox (default) to build/transmit in the pruebas environment with NO fiscal effect. Required credential header (set once in your MCP client, per-request, never stored): x-matias-token (your Matias bearer token — a JWT access_token from POST /auth/login, or a long-lived Personal Access Token from POST /auth/token). Optional x-matias-env: sandbox (default = pruebas, no fiscal effect) | production (real DIAN fiscal effect). Optional x-matias-base overrides the production base URL Matias assigns on contract. Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.

query_invoice

Look up a previously-issued Colombia document by its uuid (the Matias document UUID returned by create_invoice) to read its DIAN state — wraps GET /documents/{uuid}. Returns the document metadata Matias holds: uuid, cufe (Código Único de Facturación Electrónica), state (the DIAN acceptance state), number, dian_message and created_at. Safe to call anytime; read-only. Required credential header (set once in your MCP client, per-request, never stored): x-matias-token (your Matias bearer token — a JWT access_token from POST /auth/login, or a long-lived Personal Access Token from POST /auth/token). Optional x-matias-env: sandbox (default = pruebas, no fiscal effect) | production (real DIAN fiscal effect). Optional x-matias-base overrides the production base URL Matias assigns on contract. Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.

纠错与举报（发现条目失效、署名有误或涉及侵权？）

提交举报 / 纠错

侵权举报经核验成立后，我们会即时下线该条目并删除已存的内容副本。