Start free: issue your first NFS-e through the API
From signup to your first invoice in four steps, in the test environment.
15 free invoices per month
No credit card required.
Integrate NFS-e issuance into your product with up to 15 authorized invoices per month for one company. The allowance renews on the first day of each month.
Limit of 3 production issuances per day. Allowances use UTC and do not roll over. Tests do not consume the allowance.
Step by step
- 1.
Create an account
Sign up with your email. No credit card required.
- 2.
Create a test key
In the dashboard, create a key starting with corvo_test_. Invoices issued with it have no fiscal value.
- 3.
Register the company
Send the CNPJ, tax regime and municipality code with POST /v1/companies.
- 4.
Issue the invoice and get the webhook
Call POST /v1/invoices with an Idempotency-Key. Issuance is asynchronous: the result arrives through the nfse.invoice.authorized or nfse.invoice.rejected webhooks.
First invoice with curl
export BASE_URL='https://api.corvo.tech/v1'
export CORVO_API_KEY='corvo_test_sua_chave'
curl -X POST "$BASE_URL/invoices" \
-H "X-API-Key: $CORVO_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: pedido_123_emissao' \
-d '{
"companyTaxId": "11222333000181",
"externalId": "pedido_123",
"customer": { "name": "Cliente Exemplo", "taxId": "52998224725" },
"service": { "description": "Prestação de serviço" },
"amount": 150.50
}'