Emitir Nota de Produto (NF-e)
curl --request POST \
--url https://invo.work/api/nfe/v1/notas \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"codigo_externo": "<string>",
"natureza_operacao": "<string>",
"destinatario": {
"razao_social": "<string>",
"cpf_cnpj": "<string>",
"indicador_ie": 123,
"endereco": {
"cep": "<string>",
"logradouro": "<string>",
"numero": "<string>",
"bairro": "<string>",
"municipio": "<string>",
"uf": "<string>",
"complemento": "<string>"
},
"inscricao_estadual": "<string>",
"email": "<string>",
"telefone": "<string>",
"codigo_municipio": "<string>"
},
"itens": [
{
"quantidade": "<string>",
"codigo_produto": "<string>",
"codigo": "<string>",
"descricao": "<string>",
"ncm": "<string>",
"cest": "<string>",
"cfop": "<string>",
"unidade_comercial": "<string>",
"valor_unitario": "<string>",
"valor_desconto": "<string>",
"origem": 123,
"cst_icms": "<string>",
"csosn": "<string>",
"aliquota_icms": "<string>",
"cst_pis": "<string>",
"cst_cofins": "<string>",
"cst_ipi": "<string>",
"aliquota_ipi": "<string>"
}
],
"serie": 123,
"tipo_operacao": 123,
"finalidade": 123,
"indicador_consumidor_final": true,
"indicador_presenca": 123,
"informacoes_complementares": "<string>",
"data_saida": "<string>",
"pagamentos": [
{
"forma_pagamento": "<string>",
"valor": "<string>",
"indicador_pagamento": 123,
"data": "<string>",
"descricao": "<string>",
"cnpj_transacional": "<string>",
"uf_transacional": "<string>"
}
],
"troco": "<string>"
}
'import requests
url = "https://invo.work/api/nfe/v1/notas"
payload = {
"codigo_externo": "<string>",
"natureza_operacao": "<string>",
"destinatario": {
"razao_social": "<string>",
"cpf_cnpj": "<string>",
"indicador_ie": 123,
"endereco": {
"cep": "<string>",
"logradouro": "<string>",
"numero": "<string>",
"bairro": "<string>",
"municipio": "<string>",
"uf": "<string>",
"complemento": "<string>"
},
"inscricao_estadual": "<string>",
"email": "<string>",
"telefone": "<string>",
"codigo_municipio": "<string>"
},
"itens": [
{
"quantidade": "<string>",
"codigo_produto": "<string>",
"codigo": "<string>",
"descricao": "<string>",
"ncm": "<string>",
"cest": "<string>",
"cfop": "<string>",
"unidade_comercial": "<string>",
"valor_unitario": "<string>",
"valor_desconto": "<string>",
"origem": 123,
"cst_icms": "<string>",
"csosn": "<string>",
"aliquota_icms": "<string>",
"cst_pis": "<string>",
"cst_cofins": "<string>",
"cst_ipi": "<string>",
"aliquota_ipi": "<string>"
}
],
"serie": 123,
"tipo_operacao": 123,
"finalidade": 123,
"indicador_consumidor_final": True,
"indicador_presenca": 123,
"informacoes_complementares": "<string>",
"data_saida": "<string>",
"pagamentos": [
{
"forma_pagamento": "<string>",
"valor": "<string>",
"indicador_pagamento": 123,
"data": "<string>",
"descricao": "<string>",
"cnpj_transacional": "<string>",
"uf_transacional": "<string>"
}
],
"troco": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
codigo_externo: '<string>',
natureza_operacao: '<string>',
destinatario: {
razao_social: '<string>',
cpf_cnpj: '<string>',
indicador_ie: 123,
endereco: {
cep: '<string>',
logradouro: '<string>',
numero: '<string>',
bairro: '<string>',
municipio: '<string>',
uf: '<string>',
complemento: '<string>'
},
inscricao_estadual: '<string>',
email: '<string>',
telefone: '<string>',
codigo_municipio: '<string>'
},
itens: [
{
quantidade: '<string>',
codigo_produto: '<string>',
codigo: '<string>',
descricao: '<string>',
ncm: '<string>',
cest: '<string>',
cfop: '<string>',
unidade_comercial: '<string>',
valor_unitario: '<string>',
valor_desconto: '<string>',
origem: 123,
cst_icms: '<string>',
csosn: '<string>',
aliquota_icms: '<string>',
cst_pis: '<string>',
cst_cofins: '<string>',
cst_ipi: '<string>',
aliquota_ipi: '<string>'
}
],
serie: 123,
tipo_operacao: 123,
finalidade: 123,
indicador_consumidor_final: true,
indicador_presenca: 123,
informacoes_complementares: '<string>',
data_saida: '<string>',
pagamentos: [
{
forma_pagamento: '<string>',
valor: '<string>',
indicador_pagamento: 123,
data: '<string>',
descricao: '<string>',
cnpj_transacional: '<string>',
uf_transacional: '<string>'
}
],
troco: '<string>'
})
};
fetch('https://invo.work/api/nfe/v1/notas', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://invo.work/api/nfe/v1/notas",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'codigo_externo' => '<string>',
'natureza_operacao' => '<string>',
'destinatario' => [
'razao_social' => '<string>',
'cpf_cnpj' => '<string>',
'indicador_ie' => 123,
'endereco' => [
'cep' => '<string>',
'logradouro' => '<string>',
'numero' => '<string>',
'bairro' => '<string>',
'municipio' => '<string>',
'uf' => '<string>',
'complemento' => '<string>'
],
'inscricao_estadual' => '<string>',
'email' => '<string>',
'telefone' => '<string>',
'codigo_municipio' => '<string>'
],
'itens' => [
[
'quantidade' => '<string>',
'codigo_produto' => '<string>',
'codigo' => '<string>',
'descricao' => '<string>',
'ncm' => '<string>',
'cest' => '<string>',
'cfop' => '<string>',
'unidade_comercial' => '<string>',
'valor_unitario' => '<string>',
'valor_desconto' => '<string>',
'origem' => 123,
'cst_icms' => '<string>',
'csosn' => '<string>',
'aliquota_icms' => '<string>',
'cst_pis' => '<string>',
'cst_cofins' => '<string>',
'cst_ipi' => '<string>',
'aliquota_ipi' => '<string>'
]
],
'serie' => 123,
'tipo_operacao' => 123,
'finalidade' => 123,
'indicador_consumidor_final' => true,
'indicador_presenca' => 123,
'informacoes_complementares' => '<string>',
'data_saida' => '<string>',
'pagamentos' => [
[
'forma_pagamento' => '<string>',
'valor' => '<string>',
'indicador_pagamento' => 123,
'data' => '<string>',
'descricao' => '<string>',
'cnpj_transacional' => '<string>',
'uf_transacional' => '<string>'
]
],
'troco' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://invo.work/api/nfe/v1/notas"
payload := strings.NewReader("{\n \"codigo_externo\": \"<string>\",\n \"natureza_operacao\": \"<string>\",\n \"destinatario\": {\n \"razao_social\": \"<string>\",\n \"cpf_cnpj\": \"<string>\",\n \"indicador_ie\": 123,\n \"endereco\": {\n \"cep\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"numero\": \"<string>\",\n \"bairro\": \"<string>\",\n \"municipio\": \"<string>\",\n \"uf\": \"<string>\",\n \"complemento\": \"<string>\"\n },\n \"inscricao_estadual\": \"<string>\",\n \"email\": \"<string>\",\n \"telefone\": \"<string>\",\n \"codigo_municipio\": \"<string>\"\n },\n \"itens\": [\n {\n \"quantidade\": \"<string>\",\n \"codigo_produto\": \"<string>\",\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cest\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade_comercial\": \"<string>\",\n \"valor_unitario\": \"<string>\",\n \"valor_desconto\": \"<string>\",\n \"origem\": 123,\n \"cst_icms\": \"<string>\",\n \"csosn\": \"<string>\",\n \"aliquota_icms\": \"<string>\",\n \"cst_pis\": \"<string>\",\n \"cst_cofins\": \"<string>\",\n \"cst_ipi\": \"<string>\",\n \"aliquota_ipi\": \"<string>\"\n }\n ],\n \"serie\": 123,\n \"tipo_operacao\": 123,\n \"finalidade\": 123,\n \"indicador_consumidor_final\": true,\n \"indicador_presenca\": 123,\n \"informacoes_complementares\": \"<string>\",\n \"data_saida\": \"<string>\",\n \"pagamentos\": [\n {\n \"forma_pagamento\": \"<string>\",\n \"valor\": \"<string>\",\n \"indicador_pagamento\": 123,\n \"data\": \"<string>\",\n \"descricao\": \"<string>\",\n \"cnpj_transacional\": \"<string>\",\n \"uf_transacional\": \"<string>\"\n }\n ],\n \"troco\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://invo.work/api/nfe/v1/notas")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"codigo_externo\": \"<string>\",\n \"natureza_operacao\": \"<string>\",\n \"destinatario\": {\n \"razao_social\": \"<string>\",\n \"cpf_cnpj\": \"<string>\",\n \"indicador_ie\": 123,\n \"endereco\": {\n \"cep\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"numero\": \"<string>\",\n \"bairro\": \"<string>\",\n \"municipio\": \"<string>\",\n \"uf\": \"<string>\",\n \"complemento\": \"<string>\"\n },\n \"inscricao_estadual\": \"<string>\",\n \"email\": \"<string>\",\n \"telefone\": \"<string>\",\n \"codigo_municipio\": \"<string>\"\n },\n \"itens\": [\n {\n \"quantidade\": \"<string>\",\n \"codigo_produto\": \"<string>\",\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cest\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade_comercial\": \"<string>\",\n \"valor_unitario\": \"<string>\",\n \"valor_desconto\": \"<string>\",\n \"origem\": 123,\n \"cst_icms\": \"<string>\",\n \"csosn\": \"<string>\",\n \"aliquota_icms\": \"<string>\",\n \"cst_pis\": \"<string>\",\n \"cst_cofins\": \"<string>\",\n \"cst_ipi\": \"<string>\",\n \"aliquota_ipi\": \"<string>\"\n }\n ],\n \"serie\": 123,\n \"tipo_operacao\": 123,\n \"finalidade\": 123,\n \"indicador_consumidor_final\": true,\n \"indicador_presenca\": 123,\n \"informacoes_complementares\": \"<string>\",\n \"data_saida\": \"<string>\",\n \"pagamentos\": [\n {\n \"forma_pagamento\": \"<string>\",\n \"valor\": \"<string>\",\n \"indicador_pagamento\": 123,\n \"data\": \"<string>\",\n \"descricao\": \"<string>\",\n \"cnpj_transacional\": \"<string>\",\n \"uf_transacional\": \"<string>\"\n }\n ],\n \"troco\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://invo.work/api/nfe/v1/notas")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"codigo_externo\": \"<string>\",\n \"natureza_operacao\": \"<string>\",\n \"destinatario\": {\n \"razao_social\": \"<string>\",\n \"cpf_cnpj\": \"<string>\",\n \"indicador_ie\": 123,\n \"endereco\": {\n \"cep\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"numero\": \"<string>\",\n \"bairro\": \"<string>\",\n \"municipio\": \"<string>\",\n \"uf\": \"<string>\",\n \"complemento\": \"<string>\"\n },\n \"inscricao_estadual\": \"<string>\",\n \"email\": \"<string>\",\n \"telefone\": \"<string>\",\n \"codigo_municipio\": \"<string>\"\n },\n \"itens\": [\n {\n \"quantidade\": \"<string>\",\n \"codigo_produto\": \"<string>\",\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cest\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade_comercial\": \"<string>\",\n \"valor_unitario\": \"<string>\",\n \"valor_desconto\": \"<string>\",\n \"origem\": 123,\n \"cst_icms\": \"<string>\",\n \"csosn\": \"<string>\",\n \"aliquota_icms\": \"<string>\",\n \"cst_pis\": \"<string>\",\n \"cst_cofins\": \"<string>\",\n \"cst_ipi\": \"<string>\",\n \"aliquota_ipi\": \"<string>\"\n }\n ],\n \"serie\": 123,\n \"tipo_operacao\": 123,\n \"finalidade\": 123,\n \"indicador_consumidor_final\": true,\n \"indicador_presenca\": 123,\n \"informacoes_complementares\": \"<string>\",\n \"data_saida\": \"<string>\",\n \"pagamentos\": [\n {\n \"forma_pagamento\": \"<string>\",\n \"valor\": \"<string>\",\n \"indicador_pagamento\": 123,\n \"data\": \"<string>\",\n \"descricao\": \"<string>\",\n \"cnpj_transacional\": \"<string>\",\n \"uf_transacional\": \"<string>\"\n }\n ],\n \"troco\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"uuid": "<string>",
"codigo_externo": "<string>",
"modelo": "<string>",
"natureza_operacao": "<string>",
"situacao": "<string>",
"chave_acesso": "<string>",
"totais": {
"valor_produtos": "<string>",
"valor_frete": "<string>",
"valor_seguro": "<string>",
"valor_desconto": "<string>",
"valor_outras_despesas": "<string>",
"valor_bc_icms": "<string>",
"valor_icms": "<string>",
"valor_bc_icms_st": "<string>",
"valor_icms_st": "<string>",
"valor_ipi": "<string>",
"valor_pis": "<string>",
"valor_cofins": "<string>",
"valor_ii": "<string>",
"valor_total": "<string>"
},
"itens": [
{
"numero_item": 123,
"descricao": "<string>",
"ncm": "<string>",
"cfop": "<string>",
"unidade_comercial": "<string>",
"quantidade": "<string>",
"valor_unitario": "<string>",
"valor_total": "<string>",
"valor_desconto": "<string>",
"codigo": "<string>",
"cest": "<string>",
"origem": 123,
"cst_icms": "<string>",
"csosn": "<string>",
"aliquota_icms": "<string>",
"cst_pis": "<string>",
"cst_cofins": "<string>",
"cst_ipi": "<string>",
"aliquota_ipi": "<string>"
}
],
"pagamentos": [
{
"forma_pagamento": "<string>",
"valor": "<string>",
"indicador_pagamento": 123,
"data": "<string>",
"descricao": "<string>",
"cnpj_transacional": "<string>",
"uf_transacional": "<string>",
"cartao": {
"tipo_integracao": 123,
"cnpj_credenciadora": "<string>",
"bandeira": "<string>",
"codigo_autorizacao": "<string>",
"cnpj_recebedor": "<string>",
"id_terminal": "<string>"
}
}
],
"troco": "<string>",
"destinatario": {
"razao_social": "<string>",
"cpf_cnpj": "<string>",
"endereco": {
"cep": "<string>",
"logradouro": "<string>",
"numero": "<string>",
"bairro": "<string>",
"municipio": "<string>",
"uf": "<string>",
"complemento": "<string>"
},
"email": "<string>",
"telefone": "<string>",
"indicador_ie": 123,
"inscricao_estadual": "<string>"
},
"links": {
"xml": "<string>",
"danfe": "<string>"
},
"numero": 123,
"serie": 123,
"data_emissao": "<string>",
"data_saida": "<string>",
"data_autorizacao": "<string>",
"data_cancelamento": "<string>",
"finalidade": 123,
"tipo_operacao": "<string>",
"indicador_presenca": 123,
"indicador_consumidor_final": true,
"informacoes_complementares": "<string>",
"protocolo_autorizacao": "<string>",
"protocolo_cancelamento": "<string>",
"motivo_cancelamento": "<string>",
"intermediador": {
"cnpj": "<string>",
"identificador_cadastro": "<string>"
},
"reemitida_uuid": "<string>",
"reemitida_de_uuid": "<string>"
}{
"error": "HTTP Basic: Access denied."
}{
"error": "Empresa não está apta a emitir NF-e"
}Notas de Produto
Emitir Nota de Produto (NF-e)
A emissão é assíncrona. A Invo salva a nota e põe a autorização na fila
da SEFAZ. A resposta é 201 com situacao: "pendente", e o uuid e a
chave_acesso já vêm definitivos.
Acompanhe o resultado em GET /notas/:uuid ou pelos webhooks. Depois
de nfe_solicitacao_autorizacao, o próximo webhook já traz o resultado
final: nfe_autorizada, nfe_rejeitada ou nfe_denegada. A Invo não
envia evento para o estado em_processamento. Veja
Webhooks.
Para usar uma mercadoria cadastrada, informe o codigo_produto no
item. A Invo preenche os campos fiscais a partir do cadastro:
descricao, ncm, cfop, unidade_comercial, valor_unitario,
CST/CSOSN e outros. Para trocar um desses valores, envie o campo no
item. Um campo com valor null não apaga o valor do cadastro; omita o
campo para manter o valor cadastrado. A quantidade é sempre
obrigatória. Um codigo_produto que não existe na empresa retorna
422.
aliquota_icms é uma fração decimal, como 0.18 para 18%. Não envie o
percentual (18).
O campo pagamentos[] preenche o grupo de pagamento do XML (grupo YA,
detPag). Uma nota aceita várias formas de pagamento e, quando houver,
o troco. O campo é opcional, e integrações que não o enviam
continuam iguais: sem pagamentos, a nota sai como tPag=90 (sem
pagamento), o caso do faturamento entre empresas. Com pagamentos, a
soma de valor deve ser igual ao total da nota mais o troco. A forma
90 não aparece com outras formas e exige valor zero. data (dPag)
usa o formato AAAA-MM-DD. Veja
Pagamentos.
forma_pagamento (tPag): 01 dinheiro · 02 cheque · 03 crédito
· 04 débito · 05 cartão da loja/crediário · 10 vale alimentação
· 11 vale refeição · 12 vale presente · 13 vale combustível ·
14 duplicata mercantil · 15 boleto · 16 depósito · 17 PIX
dinâmico · 18 transferência/carteira digital · 19
fidelidade/cashback · 20 PIX estático · 21 crédito em loja · 22
pagamento eletrônico não informado (falha de hardware) · 23 PIX
automático · 24 TEF book transfer · 90 sem pagamento · 91
pagamento posterior · 99 outros (exige descricao, de 2 a 60
caracteres). Crédito, débito e PIX dinâmico (03, 04 e 17) exigem
o grupo cartao. Só as formas 03, 04, 10, 11, 12, 13, 15,
17, 18, 23 e 24 aceitam o grupo cartao.
Grupo cartao: tipo_integracao (tpIntegra) 1 = integrado (TEF,
e-commerce ou POS integrado) · 2 = não integrado (POS avulso).
bandeira (tBand): 01 Visa · 02 Mastercard · 03 Amex · 04
Sorocred · 05 Diners · 06 Elo · 07 Hipercard · 08 Aura · 09
Cabal · 10 Alelo · 11 Banes Card · 12 CalCard · 13 Credz ·
14 Discover · 15 GoodCard · 16 GreenCard · 17 Hiper · 18
JCB · 19 Mais · 20 MaxVan · 21 Policard · 22 RedeCompras ·
23 Sodexo · 24 ValeCard · 25 Verocheque · 26 VR · 27 Ticket
· 99 outros.
Informe uf_transacional e cnpj_transacional juntos, ou nenhum dos
dois.
No Ceará, a IN 87/2025 da SEFAZ-CE vale para as operações alcançadas
(venda a consumidor final ou presencial). Nessas vendas, vincule o
pagamento eletrônico com tipo_integracao: 1, o cnpj_credenciadora
da instituição de pagamento, o codigo_autorizacao e o id_terminal.
No PIX dinâmico, o codigo_autorizacao é o e2eid. A Invo também aceita
tipo_integracao: 2, válido em todo o país, para as operações
dispensadas: venda B2B entre contribuintes do ICMS, MEI e PIX estático.
Informe intermediador quando a venda passou por um site ou uma
plataforma de terceiros, como um marketplace. cnpj é o CNPJ do
intermediador. identificador_cadastro (idCadIntTran, de 2 a 60
caracteres) é o nome de usuário ou o perfil do vendedor na plataforma.
A Invo preenche indIntermed=1 e o grupo YB (infIntermed). Com
intermediador, o indicador_presenca é obrigatório e deve ser 1,
2, 3, 4 ou 9. No Ceará, a dispensa da IN 87/2025 para a venda
não presencial em marketplace exige indicador_presenca 2
(internet) ou 3 (teleatendimento).
POST
/
notas
Emitir Nota de Produto (NF-e)
curl --request POST \
--url https://invo.work/api/nfe/v1/notas \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"codigo_externo": "<string>",
"natureza_operacao": "<string>",
"destinatario": {
"razao_social": "<string>",
"cpf_cnpj": "<string>",
"indicador_ie": 123,
"endereco": {
"cep": "<string>",
"logradouro": "<string>",
"numero": "<string>",
"bairro": "<string>",
"municipio": "<string>",
"uf": "<string>",
"complemento": "<string>"
},
"inscricao_estadual": "<string>",
"email": "<string>",
"telefone": "<string>",
"codigo_municipio": "<string>"
},
"itens": [
{
"quantidade": "<string>",
"codigo_produto": "<string>",
"codigo": "<string>",
"descricao": "<string>",
"ncm": "<string>",
"cest": "<string>",
"cfop": "<string>",
"unidade_comercial": "<string>",
"valor_unitario": "<string>",
"valor_desconto": "<string>",
"origem": 123,
"cst_icms": "<string>",
"csosn": "<string>",
"aliquota_icms": "<string>",
"cst_pis": "<string>",
"cst_cofins": "<string>",
"cst_ipi": "<string>",
"aliquota_ipi": "<string>"
}
],
"serie": 123,
"tipo_operacao": 123,
"finalidade": 123,
"indicador_consumidor_final": true,
"indicador_presenca": 123,
"informacoes_complementares": "<string>",
"data_saida": "<string>",
"pagamentos": [
{
"forma_pagamento": "<string>",
"valor": "<string>",
"indicador_pagamento": 123,
"data": "<string>",
"descricao": "<string>",
"cnpj_transacional": "<string>",
"uf_transacional": "<string>"
}
],
"troco": "<string>"
}
'import requests
url = "https://invo.work/api/nfe/v1/notas"
payload = {
"codigo_externo": "<string>",
"natureza_operacao": "<string>",
"destinatario": {
"razao_social": "<string>",
"cpf_cnpj": "<string>",
"indicador_ie": 123,
"endereco": {
"cep": "<string>",
"logradouro": "<string>",
"numero": "<string>",
"bairro": "<string>",
"municipio": "<string>",
"uf": "<string>",
"complemento": "<string>"
},
"inscricao_estadual": "<string>",
"email": "<string>",
"telefone": "<string>",
"codigo_municipio": "<string>"
},
"itens": [
{
"quantidade": "<string>",
"codigo_produto": "<string>",
"codigo": "<string>",
"descricao": "<string>",
"ncm": "<string>",
"cest": "<string>",
"cfop": "<string>",
"unidade_comercial": "<string>",
"valor_unitario": "<string>",
"valor_desconto": "<string>",
"origem": 123,
"cst_icms": "<string>",
"csosn": "<string>",
"aliquota_icms": "<string>",
"cst_pis": "<string>",
"cst_cofins": "<string>",
"cst_ipi": "<string>",
"aliquota_ipi": "<string>"
}
],
"serie": 123,
"tipo_operacao": 123,
"finalidade": 123,
"indicador_consumidor_final": True,
"indicador_presenca": 123,
"informacoes_complementares": "<string>",
"data_saida": "<string>",
"pagamentos": [
{
"forma_pagamento": "<string>",
"valor": "<string>",
"indicador_pagamento": 123,
"data": "<string>",
"descricao": "<string>",
"cnpj_transacional": "<string>",
"uf_transacional": "<string>"
}
],
"troco": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
codigo_externo: '<string>',
natureza_operacao: '<string>',
destinatario: {
razao_social: '<string>',
cpf_cnpj: '<string>',
indicador_ie: 123,
endereco: {
cep: '<string>',
logradouro: '<string>',
numero: '<string>',
bairro: '<string>',
municipio: '<string>',
uf: '<string>',
complemento: '<string>'
},
inscricao_estadual: '<string>',
email: '<string>',
telefone: '<string>',
codigo_municipio: '<string>'
},
itens: [
{
quantidade: '<string>',
codigo_produto: '<string>',
codigo: '<string>',
descricao: '<string>',
ncm: '<string>',
cest: '<string>',
cfop: '<string>',
unidade_comercial: '<string>',
valor_unitario: '<string>',
valor_desconto: '<string>',
origem: 123,
cst_icms: '<string>',
csosn: '<string>',
aliquota_icms: '<string>',
cst_pis: '<string>',
cst_cofins: '<string>',
cst_ipi: '<string>',
aliquota_ipi: '<string>'
}
],
serie: 123,
tipo_operacao: 123,
finalidade: 123,
indicador_consumidor_final: true,
indicador_presenca: 123,
informacoes_complementares: '<string>',
data_saida: '<string>',
pagamentos: [
{
forma_pagamento: '<string>',
valor: '<string>',
indicador_pagamento: 123,
data: '<string>',
descricao: '<string>',
cnpj_transacional: '<string>',
uf_transacional: '<string>'
}
],
troco: '<string>'
})
};
fetch('https://invo.work/api/nfe/v1/notas', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://invo.work/api/nfe/v1/notas",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'codigo_externo' => '<string>',
'natureza_operacao' => '<string>',
'destinatario' => [
'razao_social' => '<string>',
'cpf_cnpj' => '<string>',
'indicador_ie' => 123,
'endereco' => [
'cep' => '<string>',
'logradouro' => '<string>',
'numero' => '<string>',
'bairro' => '<string>',
'municipio' => '<string>',
'uf' => '<string>',
'complemento' => '<string>'
],
'inscricao_estadual' => '<string>',
'email' => '<string>',
'telefone' => '<string>',
'codigo_municipio' => '<string>'
],
'itens' => [
[
'quantidade' => '<string>',
'codigo_produto' => '<string>',
'codigo' => '<string>',
'descricao' => '<string>',
'ncm' => '<string>',
'cest' => '<string>',
'cfop' => '<string>',
'unidade_comercial' => '<string>',
'valor_unitario' => '<string>',
'valor_desconto' => '<string>',
'origem' => 123,
'cst_icms' => '<string>',
'csosn' => '<string>',
'aliquota_icms' => '<string>',
'cst_pis' => '<string>',
'cst_cofins' => '<string>',
'cst_ipi' => '<string>',
'aliquota_ipi' => '<string>'
]
],
'serie' => 123,
'tipo_operacao' => 123,
'finalidade' => 123,
'indicador_consumidor_final' => true,
'indicador_presenca' => 123,
'informacoes_complementares' => '<string>',
'data_saida' => '<string>',
'pagamentos' => [
[
'forma_pagamento' => '<string>',
'valor' => '<string>',
'indicador_pagamento' => 123,
'data' => '<string>',
'descricao' => '<string>',
'cnpj_transacional' => '<string>',
'uf_transacional' => '<string>'
]
],
'troco' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://invo.work/api/nfe/v1/notas"
payload := strings.NewReader("{\n \"codigo_externo\": \"<string>\",\n \"natureza_operacao\": \"<string>\",\n \"destinatario\": {\n \"razao_social\": \"<string>\",\n \"cpf_cnpj\": \"<string>\",\n \"indicador_ie\": 123,\n \"endereco\": {\n \"cep\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"numero\": \"<string>\",\n \"bairro\": \"<string>\",\n \"municipio\": \"<string>\",\n \"uf\": \"<string>\",\n \"complemento\": \"<string>\"\n },\n \"inscricao_estadual\": \"<string>\",\n \"email\": \"<string>\",\n \"telefone\": \"<string>\",\n \"codigo_municipio\": \"<string>\"\n },\n \"itens\": [\n {\n \"quantidade\": \"<string>\",\n \"codigo_produto\": \"<string>\",\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cest\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade_comercial\": \"<string>\",\n \"valor_unitario\": \"<string>\",\n \"valor_desconto\": \"<string>\",\n \"origem\": 123,\n \"cst_icms\": \"<string>\",\n \"csosn\": \"<string>\",\n \"aliquota_icms\": \"<string>\",\n \"cst_pis\": \"<string>\",\n \"cst_cofins\": \"<string>\",\n \"cst_ipi\": \"<string>\",\n \"aliquota_ipi\": \"<string>\"\n }\n ],\n \"serie\": 123,\n \"tipo_operacao\": 123,\n \"finalidade\": 123,\n \"indicador_consumidor_final\": true,\n \"indicador_presenca\": 123,\n \"informacoes_complementares\": \"<string>\",\n \"data_saida\": \"<string>\",\n \"pagamentos\": [\n {\n \"forma_pagamento\": \"<string>\",\n \"valor\": \"<string>\",\n \"indicador_pagamento\": 123,\n \"data\": \"<string>\",\n \"descricao\": \"<string>\",\n \"cnpj_transacional\": \"<string>\",\n \"uf_transacional\": \"<string>\"\n }\n ],\n \"troco\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://invo.work/api/nfe/v1/notas")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"codigo_externo\": \"<string>\",\n \"natureza_operacao\": \"<string>\",\n \"destinatario\": {\n \"razao_social\": \"<string>\",\n \"cpf_cnpj\": \"<string>\",\n \"indicador_ie\": 123,\n \"endereco\": {\n \"cep\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"numero\": \"<string>\",\n \"bairro\": \"<string>\",\n \"municipio\": \"<string>\",\n \"uf\": \"<string>\",\n \"complemento\": \"<string>\"\n },\n \"inscricao_estadual\": \"<string>\",\n \"email\": \"<string>\",\n \"telefone\": \"<string>\",\n \"codigo_municipio\": \"<string>\"\n },\n \"itens\": [\n {\n \"quantidade\": \"<string>\",\n \"codigo_produto\": \"<string>\",\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cest\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade_comercial\": \"<string>\",\n \"valor_unitario\": \"<string>\",\n \"valor_desconto\": \"<string>\",\n \"origem\": 123,\n \"cst_icms\": \"<string>\",\n \"csosn\": \"<string>\",\n \"aliquota_icms\": \"<string>\",\n \"cst_pis\": \"<string>\",\n \"cst_cofins\": \"<string>\",\n \"cst_ipi\": \"<string>\",\n \"aliquota_ipi\": \"<string>\"\n }\n ],\n \"serie\": 123,\n \"tipo_operacao\": 123,\n \"finalidade\": 123,\n \"indicador_consumidor_final\": true,\n \"indicador_presenca\": 123,\n \"informacoes_complementares\": \"<string>\",\n \"data_saida\": \"<string>\",\n \"pagamentos\": [\n {\n \"forma_pagamento\": \"<string>\",\n \"valor\": \"<string>\",\n \"indicador_pagamento\": 123,\n \"data\": \"<string>\",\n \"descricao\": \"<string>\",\n \"cnpj_transacional\": \"<string>\",\n \"uf_transacional\": \"<string>\"\n }\n ],\n \"troco\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://invo.work/api/nfe/v1/notas")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"codigo_externo\": \"<string>\",\n \"natureza_operacao\": \"<string>\",\n \"destinatario\": {\n \"razao_social\": \"<string>\",\n \"cpf_cnpj\": \"<string>\",\n \"indicador_ie\": 123,\n \"endereco\": {\n \"cep\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"numero\": \"<string>\",\n \"bairro\": \"<string>\",\n \"municipio\": \"<string>\",\n \"uf\": \"<string>\",\n \"complemento\": \"<string>\"\n },\n \"inscricao_estadual\": \"<string>\",\n \"email\": \"<string>\",\n \"telefone\": \"<string>\",\n \"codigo_municipio\": \"<string>\"\n },\n \"itens\": [\n {\n \"quantidade\": \"<string>\",\n \"codigo_produto\": \"<string>\",\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cest\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade_comercial\": \"<string>\",\n \"valor_unitario\": \"<string>\",\n \"valor_desconto\": \"<string>\",\n \"origem\": 123,\n \"cst_icms\": \"<string>\",\n \"csosn\": \"<string>\",\n \"aliquota_icms\": \"<string>\",\n \"cst_pis\": \"<string>\",\n \"cst_cofins\": \"<string>\",\n \"cst_ipi\": \"<string>\",\n \"aliquota_ipi\": \"<string>\"\n }\n ],\n \"serie\": 123,\n \"tipo_operacao\": 123,\n \"finalidade\": 123,\n \"indicador_consumidor_final\": true,\n \"indicador_presenca\": 123,\n \"informacoes_complementares\": \"<string>\",\n \"data_saida\": \"<string>\",\n \"pagamentos\": [\n {\n \"forma_pagamento\": \"<string>\",\n \"valor\": \"<string>\",\n \"indicador_pagamento\": 123,\n \"data\": \"<string>\",\n \"descricao\": \"<string>\",\n \"cnpj_transacional\": \"<string>\",\n \"uf_transacional\": \"<string>\"\n }\n ],\n \"troco\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"uuid": "<string>",
"codigo_externo": "<string>",
"modelo": "<string>",
"natureza_operacao": "<string>",
"situacao": "<string>",
"chave_acesso": "<string>",
"totais": {
"valor_produtos": "<string>",
"valor_frete": "<string>",
"valor_seguro": "<string>",
"valor_desconto": "<string>",
"valor_outras_despesas": "<string>",
"valor_bc_icms": "<string>",
"valor_icms": "<string>",
"valor_bc_icms_st": "<string>",
"valor_icms_st": "<string>",
"valor_ipi": "<string>",
"valor_pis": "<string>",
"valor_cofins": "<string>",
"valor_ii": "<string>",
"valor_total": "<string>"
},
"itens": [
{
"numero_item": 123,
"descricao": "<string>",
"ncm": "<string>",
"cfop": "<string>",
"unidade_comercial": "<string>",
"quantidade": "<string>",
"valor_unitario": "<string>",
"valor_total": "<string>",
"valor_desconto": "<string>",
"codigo": "<string>",
"cest": "<string>",
"origem": 123,
"cst_icms": "<string>",
"csosn": "<string>",
"aliquota_icms": "<string>",
"cst_pis": "<string>",
"cst_cofins": "<string>",
"cst_ipi": "<string>",
"aliquota_ipi": "<string>"
}
],
"pagamentos": [
{
"forma_pagamento": "<string>",
"valor": "<string>",
"indicador_pagamento": 123,
"data": "<string>",
"descricao": "<string>",
"cnpj_transacional": "<string>",
"uf_transacional": "<string>",
"cartao": {
"tipo_integracao": 123,
"cnpj_credenciadora": "<string>",
"bandeira": "<string>",
"codigo_autorizacao": "<string>",
"cnpj_recebedor": "<string>",
"id_terminal": "<string>"
}
}
],
"troco": "<string>",
"destinatario": {
"razao_social": "<string>",
"cpf_cnpj": "<string>",
"endereco": {
"cep": "<string>",
"logradouro": "<string>",
"numero": "<string>",
"bairro": "<string>",
"municipio": "<string>",
"uf": "<string>",
"complemento": "<string>"
},
"email": "<string>",
"telefone": "<string>",
"indicador_ie": 123,
"inscricao_estadual": "<string>"
},
"links": {
"xml": "<string>",
"danfe": "<string>"
},
"numero": 123,
"serie": 123,
"data_emissao": "<string>",
"data_saida": "<string>",
"data_autorizacao": "<string>",
"data_cancelamento": "<string>",
"finalidade": 123,
"tipo_operacao": "<string>",
"indicador_presenca": 123,
"indicador_consumidor_final": true,
"informacoes_complementares": "<string>",
"protocolo_autorizacao": "<string>",
"protocolo_cancelamento": "<string>",
"motivo_cancelamento": "<string>",
"intermediador": {
"cnpj": "<string>",
"identificador_cadastro": "<string>"
},
"reemitida_uuid": "<string>",
"reemitida_de_uuid": "<string>"
}{
"error": "HTTP Basic: Access denied."
}{
"error": "Empresa não está apta a emitir NF-e"
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Headers
CNPJ da empresa emitente. Ausente, usa a primeira empresa da conta.
Body
application/json
- Não pode ser vazio
Minimum string length:
1- Não pode ser vazio
Minimum string length:
1Show child attributes
Show child attributes
Minimum array length:
1Show child attributes
Show child attributes
Show child attributes
Show child attributes
- Número decimal codificado como texto. Por exemplo: '123.45'
- Mínimo: 0
Pattern:
^\d*\.?\d*$Show child attributes
Show child attributes
Response
Created
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
- Número decimal codificado como texto. Por exemplo: '123.45'
Pattern:
^\d*\.?\d*$Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes