Skip to content

DocsNFS-e Nacional ready

Tax Invoice API: issue NF‑e, NFS‑e and NFC‑e with a single integration

Send the data as JSON and receive the XML and PDF ready. NFS-e in the national standard, bulk issuing and invoice capture. From R$ 59.90/month.

From R$ 59.90/month

  • 14-day free trial
  • No setup fee
Docs

NF-e 10472

Sale, R$ 1,284.90

draft

Issuer

Razao Social Emitente Ltda

Recipient

Customer

  1. POST sent/v1/invoices/product/sent
  2. processinginvoiceId pi_1234567890
  3. webhooksent-product-invoice
  4. issueddelivered to the customer
  • NFC-e
  • NFS-e
  • NFS-e Nacional
  • NFCom
  • Received invoices
  • Batch download

Clients and partners

  • Santander
  • Nuvemshop
  • Tray
  • Unisuam
  • Kora Saúde
  • Fiotec
  • NDD
  • Reserva
  • Avocado Pay
  • CF Contabilidade
  • SolarGrid
  • Transfero
  • RioCard Mais
  • WAM Group
CNPJs issuing invoices at SplitC
200+
tax invoices issued by Theos
350k+

How it works

  1. 1Create the account and generate the API key

    Request access, get the key and register the issuer and its digital certificate. A single key serves several companies.

  2. 2Test in the staging environment

    The development environment has its own URL, to validate the integration before issuing real invoices.

  3. 3Send the invoice data as JSON

    POST /v1/invoices/product/sent validates the data and returns the invoiceId with status processing.

  4. 4Receive the XML, the PDF and the status by webhook

    Every invoice event reaches your endpoint, and the XML and PDF are available for download.

Your first invoice in a few lines

# Shortened body. The full schema is in the documentation.
curl -X POST "https://api.twdocs.com.br/v1/invoices/product/sent" \
  -H "Authorization: Bearer $DOCS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "natureza_operacao": "Venda",
    "data_emissao": "2024-05-12",
    "tipo_documento": 1,
    "finalidade_emissao": 1,
    "cnpj_emitente": "SEU_CNPJ",
    "nome_emitente": "Razao Social Emitente Ltda",
    "uf_emitente": "SP"
  }'

Differentiators

Bulk issuing from a spreadsheet

Municipal NFS-e and NFS-e Nacional in batches: generate the template, fill one row per invoice and upload the CSV. The API validates the file before creating the batch.

  • POST /v1/invoices/service-nacional/sent/batch/generate-template
  • Template, CSV upload and validation
  • Event sent-service-invoice-nacional

Several CNPJs in one account

One API key serves every registered company, from 1 CNPJ on Inicial to unlimited CNPJs on Escala.

Webhooks

One event per change: invoice sent, received, imported and download batch ready, with redelivery.

Ready for CBS and IBS

The tax reform fields are already in the NF-e, the NFS-e Nacional and the bulk issuing CSV.

Technical support in Portuguese

Ticket support on the paid plans, and a direct channel on the Enterprise plan.

Tax reform: the CBS and IBS fields are already in the API

Send IBS and CBS in the items and in the invoice totals, in the same JSON you already use to issue.

Mandatory on the NF-e since
April 1, 2026
Legal basis
Joint Act RFB/CGIBS No. 1
Already in the API
NF-e, NFS-e Nacional and the bulk issuing CSV
POST /v1/invoices/product/sent · itens[0]Tax reform fields
{  "descricao": "Descrição do produto",  "cfop": "5102",  "valor_bruto": "47.23",  "icms_situacao_tributaria": "41",  "ibs_cbs_situacao_tributaria": "000",  "ibs_cbs_classificacao_tributaria": "000001",  "ibs_cbs_base_calculo": "47.23",  "ibs_uf_aliquota": "0.10",  "ibs_uf_valor": "0.05",  "ibs_mun_aliquota": "0.00",  "ibs_mun_valor": "0.00",  "cbs_aliquota": "0.90",  "cbs_valor": "0.43"}

Plans from R$ 59.90/month

No setup fee

  • Starter

    R$ 59.90/ month

    1 CNPJ

    100 invoices included / month

    R$ 0.20 per additional invoice

    • Issuance and capture of NF‑e, NFS‑e and CT‑e
    • Issuance of NFC‑e, NFCom and NFS‑e Nacional
    • Ticket support

    14-day free trial

    Start free trial
  • Growth

    R$ 109.90/ month

    Up to 5 CNPJs

    100 invoices per CNPJ included / month

    R$ 0.15 per additional invoice

    • Issuance and capture of NF‑e, NFS‑e and CT‑e
    • Issuance of NFC‑e, NFCom and NFS‑e Nacional
    • Ticket support

    14-day free trial

    Start free trial
  • Scale

    Recommended

    R$ 529.00/ month

    Unlimited CNPJs

    4,000 invoices included / month

    R$ 0.12 per additional invoice

    • Issuance and capture of NF‑e, NFS‑e and CT‑e
    • Issuance of NFC‑e, NFCom and NFS‑e Nacional
    • Ticket support

    14-day free trial

    Start free trial
  • Enterprise

    Custom

    From R$ 1,058.00

    Quota to be defined

    Additional invoice price to be defined

    • Issuance and capture of NF‑e, NFS‑e and CT‑e
    • Issuance of NFC‑e, NFCom and NFS‑e Nacional
    • Support through a direct channel
    • Multiple payment methods
    Talk to sales

CaseTax invoices

Theos integrated in 1 day

Since then, it has issued more than 350,000 tax invoices with Openi.

to integrate the API
1 day
tax invoices issued since the integration
350k+
From issuance to invoice event
Example
Invoice sent (API)Event (webhook)
  • NFS-e · Company 1

    R$ 1,840.00

    Authorized

    Authorized

    Document available

  • NF-e · Company 2

    R$ 12,300.00

    Authorized

    Authorized

    Document available

  • NFS-e · Company 1

    R$ 560.00

    Rejected

    Rejected

    With the reason

  • NF-e · Company 3

    R$ 4,215.90

    processing

    Processing

Sample data, to illustrate the flow.

Frequently asked questions

Which documents does the API issue?

NF-e, NFC-e, NFS-e, NFS-e Nacional and NFCom. The same API captures the NF-e received against your CNPJ, the received NFS-e Nacional and the XMLs you import.

Does it work with my municipality's NFS-e and with the national standard?

The API issues municipal NFS-e, with each municipality's service options and tax codes, and NFS-e Nacional. Look up your municipality with the municipal services endpoint in the documentation.

Do I need a digital certificate?

Yes, for the services that depend on it. The certificate is registered on the company through the API, at creation or later, and its document must match the company's.

Which languages can I integrate with?

Any language that can make an HTTP call: the API is REST, with JSON and Bearer token authentication. The documentation has examples in cURL, JavaScript, Node.js, Python and PHP.

Can I issue for several CNPJs?

Yes. One key serves several companies: Inicial covers 1 CNPJ, Expansão up to 5 and Escala unlimited CNPJs.

How does the free trial work?

You get a 14-day free trial, and the staging environment lets you validate the integration before issuing in production.

How much does it cost after the trial?

Plans start at R$ 59.90 a month with 100 invoices included. Expansão costs R$ 109.90 and covers up to 5 CNPJs, and Escala costs R$ 529.00 with 4,000 invoices. Each extra invoice costs from R$ 0.20 down to R$ 0.12.

Role
Monthly volume of invoices
Invoice types (optional)

By sending, you agree to the Privacy Policy (in Portuguese).