Brazil Invoices (NFS-e nota fiscal de serviço) MCP server

Cancel (void) an authorized Brazil NFS-e at the prefeitura, using its ref. Requires a justificativa (cancellation reason) of 15 to 255 characters. Only an AUTHORIZED NFS-e can be canceled; cancellation is permanent.

Issue a Brazil NFS-e (nota fiscal de serviço eletrônica — the electronic service invoice municipalities/prefeituras require). Two interchangeable providers behind one tool (bring your own credentials as HTTP headers; this server stores nothing, and the merchant certificate + municipal registration stay in the merchant's own provider account): (A) FOCUS NFe — header x-focusnfe-token (free homologação/sandbox token issues test NFS-e with no fiscal effect; the produção token issues real ones; add x-focusnfe-mode: production to switch, default is the safer sandbox). (B) NFE.IO — headers x-nfeio-key (your NFe.io API key) + x-nfeio-company-id (the id of your issuing company/empresa in NFe.io, which holds the CNPJ, municipal registration and certificate; whether it is a Test or Production company — and thus fiscal effect — is set in your NFe.io account, not per request). Routing: whichever credential headers you send picks the provider; if both are present Focus NFe wins unless you set header x-invoice-provider: nfeio. ISSUANCE IS ASYNCHRONOUS: this returns status PROCESSING plus a ref — poll query_invoice with that ref until AUTHORIZED (nota autorizada) or ERROR. Ref semantics differ: with Focus NFe the ref is yours (auto-generated if omitted); with NFe.io the ref returned is NFe.io's own invoice id (a passed-in ref is ignored). For NFe.io the issuer comes from x-nfeio-company-id, so the prestador_* fields are validated but not forwarded. This is for service invoices (serviços); NF-e for physical goods is on the v2 roadmap.

Check a Brazil NFS-e created by create_invoice, using its ref. Status values: PROCESSING (prefeitura is still authorizing — poll again shortly), AUTHORIZED (nota autorizada — numero and codigo_verificacao are populated, url links the official NFS-e), ERROR (authorization was rejected — see message for the reason), CANCELED (voided). Safe to call anytime.