Uruguay Invoices (DGI e-Factura CFE, merchant-signed SOAP relay) MCP server

Reference (pure-local, NO network): the DGI e-Factura webservice endpoints, the three SOAP operations and their SOAPActions, the CFE document-type codes (TipoCFE), and the IVA rates/namespaces — so an agent can orient before signing. The test (ePrueba) endpoint is verified live; produccion must be confirmed against your DGI onboarding. No credentials needed.

Submit a Sobre (envelope of one or more signed CFEs — e-Factura / e-Ticket and their notas) to Uruguay DGI e-Factura via the EFACRECEPCIONSOBRE webservice operation. You pass an ALREADY WS-Security-signed SOAP envelope (base64); this server forwards it to DGI and translates the reply. Result: accepted=true with estado AS (Sobre Recibido — DGI accepted the envelope) or accepted=false with estado BS (Sobre Rechazado — see motivos_rechazo). On acceptance DGI returns consulta_token + consulta_fechahora — use them later with query_envio_status to fetch the 2nd message (per-CFE response). How signing works: DGI requires message-level WS-Security — you sign the CFE XML, build + sign the Sobre, and X.509-sign the SOAP envelope with your Uruguayan CA certificate (e.g. from Correo Uruguayo), all merchant-side. This server stores nothing and never sees your private key; it forwards the finished envelope. Endpoint headers: x-dgi-mode = test (default, ePrueba sandbox — no fiscal effect) | homologacion | produccion; or x-dgi-endpoint to point at an explicit DGI webservice URL. Owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools are honored.

Submit a Reporte Diario (daily report of the CFEs issued that day, including any anulados) to Uruguay DGI via the EFACRECEPCIONREPORTE webservice operation. Same shape as submit_sobre: pass an ALREADY WS-Security-signed SOAP envelope (base64) whose Body wraps your signed Reporte Diario XML; this server forwards it. Result carries the DGI acknowledgement (estado + any motivos_rechazo). The daily report is mandatory for emisores electrónicos. How signing works: DGI requires message-level WS-Security — you sign the CFE XML, build + sign the Sobre, and X.509-sign the SOAP envelope with your Uruguayan CA certificate (e.g. from Correo Uruguayo), all merchant-side. This server stores nothing and never sees your private key; it forwards the finished envelope. Endpoint headers: x-dgi-mode = test (default, ePrueba sandbox — no fiscal effect) | homologacion | produccion; or x-dgi-endpoint to point at an explicit DGI webservice URL. Owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools are honored.

Query the status of a previous DGI submission via the EFACCONSULTARESTADOENVIO webservice operation — e.g. to fetch the 2nd message (per-CFE response) using the consulta_token + consulta_fechahora that submit_sobre returned. Pass an ALREADY WS-Security-signed SOAP envelope (base64) whose Body wraps your signed consulta request; this server forwards it and returns the DGI response document. Safe/read-only at DGI. How signing works: DGI requires message-level WS-Security — you sign the CFE XML, build + sign the Sobre, and X.509-sign the SOAP envelope with your Uruguayan CA certificate (e.g. from Correo Uruguayo), all merchant-side. This server stores nothing and never sees your private key; it forwards the finished envelope. Endpoint headers: x-dgi-mode = test (default, ePrueba sandbox — no fiscal effect) | homologacion | produccion; or x-dgi-endpoint to point at an explicit DGI webservice URL. Owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools are honored.

Helper (pure-local, NO network, NO signing): given your signed inner DGI XML document, returns the exact SOAP 1.1 envelope Body you must WS-Security-sign before submitting. This makes the DGI Datain/xmlData structure explicit so you sign the right bytes. operation = sobre (EFACRECEPCIONSOBRE, default) | reporte (EFACRECEPCIONREPORTE) | consulta (EFACCONSULTARESTADOENVIO). Returns the envelope XML plus its base64 (unsigned — you still must add the WS-Security X.509 signature over the Body, then base64 the SIGNED envelope for submit_sobre/submit_reporte_diario/query_envio_status). Nothing is sent anywhere.

Compute Uruguay IVA and CFE MontosTotales from line items (pure-local, NO network). Uruguay IVA: Tasa Básica 22%, Tasa Mínima 10%, Exento 0%. Give items with net_price (tax-EXCLUSIVE unit price), optional quantity, and either iva_rate (22 | 10 | 0) or indfact (3 | 2 | 1). Returns the CFE MontosTotales fields: MntNetoIvaTasaBasica / MntNetoIvaTasaMin / MntExento, IVATasaBasica=22 / IVATasaMin=10, MntIVATasaBasica / MntIVATasaMin, and MntTotal — ready to place in the CFE before you sign it. Amounts in UYU (or set moneda).