Emitir NFC-e (Modelo 65)
curl --request POST \
--url https://api.engineapi.com.br/v1/nfce \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"codigo": "<string>",
"descricao": "<string>",
"ncm": "<string>",
"cfop": "<string>",
"unidade": "<string>",
"quantidade": 1.0001,
"valorUnitario": 1.01,
"ean": "<string>",
"cest": "<string>",
"cBenef": "<string>",
"valorTotal": 123,
"desconto": 1,
"valorFrete": 1,
"valorSeguro": 1,
"outrasDespesas": 1,
"indTot": 123,
"icms": {
"origem": 0,
"csosn": "<string>",
"cst": "<string>",
"aliquota": 123,
"baseCalculo": 123,
"valor": 123,
"baseCalculoST": 123,
"aliquotaST": 123,
"valorST": 123,
"qBCMono": 123,
"adRemICMS": 123,
"vICMSMono": 123,
"qBCMonoRet": 123,
"adRemICMSRet": 123,
"vICMSMonoRet": 123
},
"pis": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123
},
"cofins": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123
},
"ipi": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123,
"cEnq": "<string>"
},
"ibsCbs": {
"ibsUf": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"ibsMun": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"cbs": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"cst": "<string>",
"cClassTrib": "<string>",
"vBC": 1,
"vIbs": 1
}
}
],
"pagamentos": [
{
"valor": 1
}
],
"issuerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"serie": 123,
"numero": 123,
"destCPF": "<string>",
"destNome": "<string>",
"troco": 1,
"cobranca": {
"duplicatas": [
{
"vencimento": "<string>",
"valor": 1.01,
"numero": "<string>"
}
]
},
"informacoesComplementares": "<string>",
"resolverTributacao": true
}
'import requests
url = "https://api.engineapi.com.br/v1/nfce"
payload = {
"items": [
{
"codigo": "<string>",
"descricao": "<string>",
"ncm": "<string>",
"cfop": "<string>",
"unidade": "<string>",
"quantidade": 1.0001,
"valorUnitario": 1.01,
"ean": "<string>",
"cest": "<string>",
"cBenef": "<string>",
"valorTotal": 123,
"desconto": 1,
"valorFrete": 1,
"valorSeguro": 1,
"outrasDespesas": 1,
"indTot": 123,
"icms": {
"origem": 0,
"csosn": "<string>",
"cst": "<string>",
"aliquota": 123,
"baseCalculo": 123,
"valor": 123,
"baseCalculoST": 123,
"aliquotaST": 123,
"valorST": 123,
"qBCMono": 123,
"adRemICMS": 123,
"vICMSMono": 123,
"qBCMonoRet": 123,
"adRemICMSRet": 123,
"vICMSMonoRet": 123
},
"pis": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123
},
"cofins": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123
},
"ipi": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123,
"cEnq": "<string>"
},
"ibsCbs": {
"ibsUf": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"ibsMun": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"cbs": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"cst": "<string>",
"cClassTrib": "<string>",
"vBC": 1,
"vIbs": 1
}
}
],
"pagamentos": [{ "valor": 1 }],
"issuerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"serie": 123,
"numero": 123,
"destCPF": "<string>",
"destNome": "<string>",
"troco": 1,
"cobranca": { "duplicatas": [
{
"vencimento": "<string>",
"valor": 1.01,
"numero": "<string>"
}
] },
"informacoesComplementares": "<string>",
"resolverTributacao": True
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
codigo: '<string>',
descricao: '<string>',
ncm: '<string>',
cfop: '<string>',
unidade: '<string>',
quantidade: 1.0001,
valorUnitario: 1.01,
ean: '<string>',
cest: '<string>',
cBenef: '<string>',
valorTotal: 123,
desconto: 1,
valorFrete: 1,
valorSeguro: 1,
outrasDespesas: 1,
indTot: 123,
icms: {
origem: 0,
csosn: '<string>',
cst: '<string>',
aliquota: 123,
baseCalculo: 123,
valor: 123,
baseCalculoST: 123,
aliquotaST: 123,
valorST: 123,
qBCMono: 123,
adRemICMS: 123,
vICMSMono: 123,
qBCMonoRet: 123,
adRemICMSRet: 123,
vICMSMonoRet: 123
},
pis: {cst: '<string>', baseCalculo: 123, aliquota: 123, valor: 123},
cofins: {cst: '<string>', baseCalculo: 123, aliquota: 123, valor: 123},
ipi: {cst: '<string>', baseCalculo: 123, aliquota: 123, valor: 123, cEnq: '<string>'},
ibsCbs: {
ibsUf: {p: 1, pNominal: 1, pRedAliq: 50, v: 1},
ibsMun: {p: 1, pNominal: 1, pRedAliq: 50, v: 1},
cbs: {p: 1, pNominal: 1, pRedAliq: 50, v: 1},
cst: '<string>',
cClassTrib: '<string>',
vBC: 1,
vIbs: 1
}
}
],
pagamentos: [{valor: 1}],
issuerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
serie: 123,
numero: 123,
destCPF: '<string>',
destNome: '<string>',
troco: 1,
cobranca: {duplicatas: [{vencimento: '<string>', valor: 1.01, numero: '<string>'}]},
informacoesComplementares: '<string>',
resolverTributacao: true
})
};
fetch('https://api.engineapi.com.br/v1/nfce', 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://api.engineapi.com.br/v1/nfce",
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([
'items' => [
[
'codigo' => '<string>',
'descricao' => '<string>',
'ncm' => '<string>',
'cfop' => '<string>',
'unidade' => '<string>',
'quantidade' => 1.0001,
'valorUnitario' => 1.01,
'ean' => '<string>',
'cest' => '<string>',
'cBenef' => '<string>',
'valorTotal' => 123,
'desconto' => 1,
'valorFrete' => 1,
'valorSeguro' => 1,
'outrasDespesas' => 1,
'indTot' => 123,
'icms' => [
'origem' => 0,
'csosn' => '<string>',
'cst' => '<string>',
'aliquota' => 123,
'baseCalculo' => 123,
'valor' => 123,
'baseCalculoST' => 123,
'aliquotaST' => 123,
'valorST' => 123,
'qBCMono' => 123,
'adRemICMS' => 123,
'vICMSMono' => 123,
'qBCMonoRet' => 123,
'adRemICMSRet' => 123,
'vICMSMonoRet' => 123
],
'pis' => [
'cst' => '<string>',
'baseCalculo' => 123,
'aliquota' => 123,
'valor' => 123
],
'cofins' => [
'cst' => '<string>',
'baseCalculo' => 123,
'aliquota' => 123,
'valor' => 123
],
'ipi' => [
'cst' => '<string>',
'baseCalculo' => 123,
'aliquota' => 123,
'valor' => 123,
'cEnq' => '<string>'
],
'ibsCbs' => [
'ibsUf' => [
'p' => 1,
'pNominal' => 1,
'pRedAliq' => 50,
'v' => 1
],
'ibsMun' => [
'p' => 1,
'pNominal' => 1,
'pRedAliq' => 50,
'v' => 1
],
'cbs' => [
'p' => 1,
'pNominal' => 1,
'pRedAliq' => 50,
'v' => 1
],
'cst' => '<string>',
'cClassTrib' => '<string>',
'vBC' => 1,
'vIbs' => 1
]
]
],
'pagamentos' => [
[
'valor' => 1
]
],
'issuerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'serie' => 123,
'numero' => 123,
'destCPF' => '<string>',
'destNome' => '<string>',
'troco' => 1,
'cobranca' => [
'duplicatas' => [
[
'vencimento' => '<string>',
'valor' => 1.01,
'numero' => '<string>'
]
]
],
'informacoesComplementares' => '<string>',
'resolverTributacao' => true
]),
CURLOPT_HTTPHEADER => [
"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://api.engineapi.com.br/v1/nfce"
payload := strings.NewReader("{\n \"items\": [\n {\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade\": \"<string>\",\n \"quantidade\": 1.0001,\n \"valorUnitario\": 1.01,\n \"ean\": \"<string>\",\n \"cest\": \"<string>\",\n \"cBenef\": \"<string>\",\n \"valorTotal\": 123,\n \"desconto\": 1,\n \"valorFrete\": 1,\n \"valorSeguro\": 1,\n \"outrasDespesas\": 1,\n \"indTot\": 123,\n \"icms\": {\n \"origem\": 0,\n \"csosn\": \"<string>\",\n \"cst\": \"<string>\",\n \"aliquota\": 123,\n \"baseCalculo\": 123,\n \"valor\": 123,\n \"baseCalculoST\": 123,\n \"aliquotaST\": 123,\n \"valorST\": 123,\n \"qBCMono\": 123,\n \"adRemICMS\": 123,\n \"vICMSMono\": 123,\n \"qBCMonoRet\": 123,\n \"adRemICMSRet\": 123,\n \"vICMSMonoRet\": 123\n },\n \"pis\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"cofins\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"ipi\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123,\n \"cEnq\": \"<string>\"\n },\n \"ibsCbs\": {\n \"ibsUf\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"ibsMun\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cbs\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cst\": \"<string>\",\n \"cClassTrib\": \"<string>\",\n \"vBC\": 1,\n \"vIbs\": 1\n }\n }\n ],\n \"pagamentos\": [\n {\n \"valor\": 1\n }\n ],\n \"issuerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"serie\": 123,\n \"numero\": 123,\n \"destCPF\": \"<string>\",\n \"destNome\": \"<string>\",\n \"troco\": 1,\n \"cobranca\": {\n \"duplicatas\": [\n {\n \"vencimento\": \"<string>\",\n \"valor\": 1.01,\n \"numero\": \"<string>\"\n }\n ]\n },\n \"informacoesComplementares\": \"<string>\",\n \"resolverTributacao\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
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://api.engineapi.com.br/v1/nfce")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade\": \"<string>\",\n \"quantidade\": 1.0001,\n \"valorUnitario\": 1.01,\n \"ean\": \"<string>\",\n \"cest\": \"<string>\",\n \"cBenef\": \"<string>\",\n \"valorTotal\": 123,\n \"desconto\": 1,\n \"valorFrete\": 1,\n \"valorSeguro\": 1,\n \"outrasDespesas\": 1,\n \"indTot\": 123,\n \"icms\": {\n \"origem\": 0,\n \"csosn\": \"<string>\",\n \"cst\": \"<string>\",\n \"aliquota\": 123,\n \"baseCalculo\": 123,\n \"valor\": 123,\n \"baseCalculoST\": 123,\n \"aliquotaST\": 123,\n \"valorST\": 123,\n \"qBCMono\": 123,\n \"adRemICMS\": 123,\n \"vICMSMono\": 123,\n \"qBCMonoRet\": 123,\n \"adRemICMSRet\": 123,\n \"vICMSMonoRet\": 123\n },\n \"pis\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"cofins\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"ipi\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123,\n \"cEnq\": \"<string>\"\n },\n \"ibsCbs\": {\n \"ibsUf\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"ibsMun\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cbs\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cst\": \"<string>\",\n \"cClassTrib\": \"<string>\",\n \"vBC\": 1,\n \"vIbs\": 1\n }\n }\n ],\n \"pagamentos\": [\n {\n \"valor\": 1\n }\n ],\n \"issuerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"serie\": 123,\n \"numero\": 123,\n \"destCPF\": \"<string>\",\n \"destNome\": \"<string>\",\n \"troco\": 1,\n \"cobranca\": {\n \"duplicatas\": [\n {\n \"vencimento\": \"<string>\",\n \"valor\": 1.01,\n \"numero\": \"<string>\"\n }\n ]\n },\n \"informacoesComplementares\": \"<string>\",\n \"resolverTributacao\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.engineapi.com.br/v1/nfce")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade\": \"<string>\",\n \"quantidade\": 1.0001,\n \"valorUnitario\": 1.01,\n \"ean\": \"<string>\",\n \"cest\": \"<string>\",\n \"cBenef\": \"<string>\",\n \"valorTotal\": 123,\n \"desconto\": 1,\n \"valorFrete\": 1,\n \"valorSeguro\": 1,\n \"outrasDespesas\": 1,\n \"indTot\": 123,\n \"icms\": {\n \"origem\": 0,\n \"csosn\": \"<string>\",\n \"cst\": \"<string>\",\n \"aliquota\": 123,\n \"baseCalculo\": 123,\n \"valor\": 123,\n \"baseCalculoST\": 123,\n \"aliquotaST\": 123,\n \"valorST\": 123,\n \"qBCMono\": 123,\n \"adRemICMS\": 123,\n \"vICMSMono\": 123,\n \"qBCMonoRet\": 123,\n \"adRemICMSRet\": 123,\n \"vICMSMonoRet\": 123\n },\n \"pis\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"cofins\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"ipi\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123,\n \"cEnq\": \"<string>\"\n },\n \"ibsCbs\": {\n \"ibsUf\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"ibsMun\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cbs\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cst\": \"<string>\",\n \"cClassTrib\": \"<string>\",\n \"vBC\": 1,\n \"vIbs\": 1\n }\n }\n ],\n \"pagamentos\": [\n {\n \"valor\": 1\n }\n ],\n \"issuerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"serie\": 123,\n \"numero\": 123,\n \"destCPF\": \"<string>\",\n \"destNome\": \"<string>\",\n \"troco\": 1,\n \"cobranca\": {\n \"duplicatas\": [\n {\n \"vencimento\": \"<string>\",\n \"valor\": 1.01,\n \"numero\": \"<string>\"\n }\n ]\n },\n \"informacoesComplementares\": \"<string>\",\n \"resolverTributacao\": true\n}"
response = http.request(request)
puts response.read_bodyNFCe
Emitir NFC-e (Modelo 65)
Emite uma NFC-e de forma síncrona: a chamada só retorna depois da resposta da SEFAZ, com o desfecho real no status do envelope (AUTHORIZED ou REJECTED). Rejeição volta como 400 com error.erros[] (código e descrição, ver Erros e Rejeições); campo inválido no payload também é 400, mas sem erros[] (a nota nunca chega na SEFAZ). Use Idempotency-Key para reenviar com segurança em caso de timeout/retry.
POST
/
v1
/
nfce
Emitir NFC-e (Modelo 65)
curl --request POST \
--url https://api.engineapi.com.br/v1/nfce \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"codigo": "<string>",
"descricao": "<string>",
"ncm": "<string>",
"cfop": "<string>",
"unidade": "<string>",
"quantidade": 1.0001,
"valorUnitario": 1.01,
"ean": "<string>",
"cest": "<string>",
"cBenef": "<string>",
"valorTotal": 123,
"desconto": 1,
"valorFrete": 1,
"valorSeguro": 1,
"outrasDespesas": 1,
"indTot": 123,
"icms": {
"origem": 0,
"csosn": "<string>",
"cst": "<string>",
"aliquota": 123,
"baseCalculo": 123,
"valor": 123,
"baseCalculoST": 123,
"aliquotaST": 123,
"valorST": 123,
"qBCMono": 123,
"adRemICMS": 123,
"vICMSMono": 123,
"qBCMonoRet": 123,
"adRemICMSRet": 123,
"vICMSMonoRet": 123
},
"pis": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123
},
"cofins": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123
},
"ipi": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123,
"cEnq": "<string>"
},
"ibsCbs": {
"ibsUf": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"ibsMun": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"cbs": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"cst": "<string>",
"cClassTrib": "<string>",
"vBC": 1,
"vIbs": 1
}
}
],
"pagamentos": [
{
"valor": 1
}
],
"issuerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"serie": 123,
"numero": 123,
"destCPF": "<string>",
"destNome": "<string>",
"troco": 1,
"cobranca": {
"duplicatas": [
{
"vencimento": "<string>",
"valor": 1.01,
"numero": "<string>"
}
]
},
"informacoesComplementares": "<string>",
"resolverTributacao": true
}
'import requests
url = "https://api.engineapi.com.br/v1/nfce"
payload = {
"items": [
{
"codigo": "<string>",
"descricao": "<string>",
"ncm": "<string>",
"cfop": "<string>",
"unidade": "<string>",
"quantidade": 1.0001,
"valorUnitario": 1.01,
"ean": "<string>",
"cest": "<string>",
"cBenef": "<string>",
"valorTotal": 123,
"desconto": 1,
"valorFrete": 1,
"valorSeguro": 1,
"outrasDespesas": 1,
"indTot": 123,
"icms": {
"origem": 0,
"csosn": "<string>",
"cst": "<string>",
"aliquota": 123,
"baseCalculo": 123,
"valor": 123,
"baseCalculoST": 123,
"aliquotaST": 123,
"valorST": 123,
"qBCMono": 123,
"adRemICMS": 123,
"vICMSMono": 123,
"qBCMonoRet": 123,
"adRemICMSRet": 123,
"vICMSMonoRet": 123
},
"pis": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123
},
"cofins": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123
},
"ipi": {
"cst": "<string>",
"baseCalculo": 123,
"aliquota": 123,
"valor": 123,
"cEnq": "<string>"
},
"ibsCbs": {
"ibsUf": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"ibsMun": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"cbs": {
"p": 1,
"pNominal": 1,
"pRedAliq": 50,
"v": 1
},
"cst": "<string>",
"cClassTrib": "<string>",
"vBC": 1,
"vIbs": 1
}
}
],
"pagamentos": [{ "valor": 1 }],
"issuerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"serie": 123,
"numero": 123,
"destCPF": "<string>",
"destNome": "<string>",
"troco": 1,
"cobranca": { "duplicatas": [
{
"vencimento": "<string>",
"valor": 1.01,
"numero": "<string>"
}
] },
"informacoesComplementares": "<string>",
"resolverTributacao": True
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
codigo: '<string>',
descricao: '<string>',
ncm: '<string>',
cfop: '<string>',
unidade: '<string>',
quantidade: 1.0001,
valorUnitario: 1.01,
ean: '<string>',
cest: '<string>',
cBenef: '<string>',
valorTotal: 123,
desconto: 1,
valorFrete: 1,
valorSeguro: 1,
outrasDespesas: 1,
indTot: 123,
icms: {
origem: 0,
csosn: '<string>',
cst: '<string>',
aliquota: 123,
baseCalculo: 123,
valor: 123,
baseCalculoST: 123,
aliquotaST: 123,
valorST: 123,
qBCMono: 123,
adRemICMS: 123,
vICMSMono: 123,
qBCMonoRet: 123,
adRemICMSRet: 123,
vICMSMonoRet: 123
},
pis: {cst: '<string>', baseCalculo: 123, aliquota: 123, valor: 123},
cofins: {cst: '<string>', baseCalculo: 123, aliquota: 123, valor: 123},
ipi: {cst: '<string>', baseCalculo: 123, aliquota: 123, valor: 123, cEnq: '<string>'},
ibsCbs: {
ibsUf: {p: 1, pNominal: 1, pRedAliq: 50, v: 1},
ibsMun: {p: 1, pNominal: 1, pRedAliq: 50, v: 1},
cbs: {p: 1, pNominal: 1, pRedAliq: 50, v: 1},
cst: '<string>',
cClassTrib: '<string>',
vBC: 1,
vIbs: 1
}
}
],
pagamentos: [{valor: 1}],
issuerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
serie: 123,
numero: 123,
destCPF: '<string>',
destNome: '<string>',
troco: 1,
cobranca: {duplicatas: [{vencimento: '<string>', valor: 1.01, numero: '<string>'}]},
informacoesComplementares: '<string>',
resolverTributacao: true
})
};
fetch('https://api.engineapi.com.br/v1/nfce', 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://api.engineapi.com.br/v1/nfce",
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([
'items' => [
[
'codigo' => '<string>',
'descricao' => '<string>',
'ncm' => '<string>',
'cfop' => '<string>',
'unidade' => '<string>',
'quantidade' => 1.0001,
'valorUnitario' => 1.01,
'ean' => '<string>',
'cest' => '<string>',
'cBenef' => '<string>',
'valorTotal' => 123,
'desconto' => 1,
'valorFrete' => 1,
'valorSeguro' => 1,
'outrasDespesas' => 1,
'indTot' => 123,
'icms' => [
'origem' => 0,
'csosn' => '<string>',
'cst' => '<string>',
'aliquota' => 123,
'baseCalculo' => 123,
'valor' => 123,
'baseCalculoST' => 123,
'aliquotaST' => 123,
'valorST' => 123,
'qBCMono' => 123,
'adRemICMS' => 123,
'vICMSMono' => 123,
'qBCMonoRet' => 123,
'adRemICMSRet' => 123,
'vICMSMonoRet' => 123
],
'pis' => [
'cst' => '<string>',
'baseCalculo' => 123,
'aliquota' => 123,
'valor' => 123
],
'cofins' => [
'cst' => '<string>',
'baseCalculo' => 123,
'aliquota' => 123,
'valor' => 123
],
'ipi' => [
'cst' => '<string>',
'baseCalculo' => 123,
'aliquota' => 123,
'valor' => 123,
'cEnq' => '<string>'
],
'ibsCbs' => [
'ibsUf' => [
'p' => 1,
'pNominal' => 1,
'pRedAliq' => 50,
'v' => 1
],
'ibsMun' => [
'p' => 1,
'pNominal' => 1,
'pRedAliq' => 50,
'v' => 1
],
'cbs' => [
'p' => 1,
'pNominal' => 1,
'pRedAliq' => 50,
'v' => 1
],
'cst' => '<string>',
'cClassTrib' => '<string>',
'vBC' => 1,
'vIbs' => 1
]
]
],
'pagamentos' => [
[
'valor' => 1
]
],
'issuerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'serie' => 123,
'numero' => 123,
'destCPF' => '<string>',
'destNome' => '<string>',
'troco' => 1,
'cobranca' => [
'duplicatas' => [
[
'vencimento' => '<string>',
'valor' => 1.01,
'numero' => '<string>'
]
]
],
'informacoesComplementares' => '<string>',
'resolverTributacao' => true
]),
CURLOPT_HTTPHEADER => [
"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://api.engineapi.com.br/v1/nfce"
payload := strings.NewReader("{\n \"items\": [\n {\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade\": \"<string>\",\n \"quantidade\": 1.0001,\n \"valorUnitario\": 1.01,\n \"ean\": \"<string>\",\n \"cest\": \"<string>\",\n \"cBenef\": \"<string>\",\n \"valorTotal\": 123,\n \"desconto\": 1,\n \"valorFrete\": 1,\n \"valorSeguro\": 1,\n \"outrasDespesas\": 1,\n \"indTot\": 123,\n \"icms\": {\n \"origem\": 0,\n \"csosn\": \"<string>\",\n \"cst\": \"<string>\",\n \"aliquota\": 123,\n \"baseCalculo\": 123,\n \"valor\": 123,\n \"baseCalculoST\": 123,\n \"aliquotaST\": 123,\n \"valorST\": 123,\n \"qBCMono\": 123,\n \"adRemICMS\": 123,\n \"vICMSMono\": 123,\n \"qBCMonoRet\": 123,\n \"adRemICMSRet\": 123,\n \"vICMSMonoRet\": 123\n },\n \"pis\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"cofins\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"ipi\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123,\n \"cEnq\": \"<string>\"\n },\n \"ibsCbs\": {\n \"ibsUf\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"ibsMun\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cbs\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cst\": \"<string>\",\n \"cClassTrib\": \"<string>\",\n \"vBC\": 1,\n \"vIbs\": 1\n }\n }\n ],\n \"pagamentos\": [\n {\n \"valor\": 1\n }\n ],\n \"issuerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"serie\": 123,\n \"numero\": 123,\n \"destCPF\": \"<string>\",\n \"destNome\": \"<string>\",\n \"troco\": 1,\n \"cobranca\": {\n \"duplicatas\": [\n {\n \"vencimento\": \"<string>\",\n \"valor\": 1.01,\n \"numero\": \"<string>\"\n }\n ]\n },\n \"informacoesComplementares\": \"<string>\",\n \"resolverTributacao\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
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://api.engineapi.com.br/v1/nfce")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade\": \"<string>\",\n \"quantidade\": 1.0001,\n \"valorUnitario\": 1.01,\n \"ean\": \"<string>\",\n \"cest\": \"<string>\",\n \"cBenef\": \"<string>\",\n \"valorTotal\": 123,\n \"desconto\": 1,\n \"valorFrete\": 1,\n \"valorSeguro\": 1,\n \"outrasDespesas\": 1,\n \"indTot\": 123,\n \"icms\": {\n \"origem\": 0,\n \"csosn\": \"<string>\",\n \"cst\": \"<string>\",\n \"aliquota\": 123,\n \"baseCalculo\": 123,\n \"valor\": 123,\n \"baseCalculoST\": 123,\n \"aliquotaST\": 123,\n \"valorST\": 123,\n \"qBCMono\": 123,\n \"adRemICMS\": 123,\n \"vICMSMono\": 123,\n \"qBCMonoRet\": 123,\n \"adRemICMSRet\": 123,\n \"vICMSMonoRet\": 123\n },\n \"pis\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"cofins\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"ipi\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123,\n \"cEnq\": \"<string>\"\n },\n \"ibsCbs\": {\n \"ibsUf\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"ibsMun\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cbs\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cst\": \"<string>\",\n \"cClassTrib\": \"<string>\",\n \"vBC\": 1,\n \"vIbs\": 1\n }\n }\n ],\n \"pagamentos\": [\n {\n \"valor\": 1\n }\n ],\n \"issuerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"serie\": 123,\n \"numero\": 123,\n \"destCPF\": \"<string>\",\n \"destNome\": \"<string>\",\n \"troco\": 1,\n \"cobranca\": {\n \"duplicatas\": [\n {\n \"vencimento\": \"<string>\",\n \"valor\": 1.01,\n \"numero\": \"<string>\"\n }\n ]\n },\n \"informacoesComplementares\": \"<string>\",\n \"resolverTributacao\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.engineapi.com.br/v1/nfce")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"codigo\": \"<string>\",\n \"descricao\": \"<string>\",\n \"ncm\": \"<string>\",\n \"cfop\": \"<string>\",\n \"unidade\": \"<string>\",\n \"quantidade\": 1.0001,\n \"valorUnitario\": 1.01,\n \"ean\": \"<string>\",\n \"cest\": \"<string>\",\n \"cBenef\": \"<string>\",\n \"valorTotal\": 123,\n \"desconto\": 1,\n \"valorFrete\": 1,\n \"valorSeguro\": 1,\n \"outrasDespesas\": 1,\n \"indTot\": 123,\n \"icms\": {\n \"origem\": 0,\n \"csosn\": \"<string>\",\n \"cst\": \"<string>\",\n \"aliquota\": 123,\n \"baseCalculo\": 123,\n \"valor\": 123,\n \"baseCalculoST\": 123,\n \"aliquotaST\": 123,\n \"valorST\": 123,\n \"qBCMono\": 123,\n \"adRemICMS\": 123,\n \"vICMSMono\": 123,\n \"qBCMonoRet\": 123,\n \"adRemICMSRet\": 123,\n \"vICMSMonoRet\": 123\n },\n \"pis\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"cofins\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123\n },\n \"ipi\": {\n \"cst\": \"<string>\",\n \"baseCalculo\": 123,\n \"aliquota\": 123,\n \"valor\": 123,\n \"cEnq\": \"<string>\"\n },\n \"ibsCbs\": {\n \"ibsUf\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"ibsMun\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cbs\": {\n \"p\": 1,\n \"pNominal\": 1,\n \"pRedAliq\": 50,\n \"v\": 1\n },\n \"cst\": \"<string>\",\n \"cClassTrib\": \"<string>\",\n \"vBC\": 1,\n \"vIbs\": 1\n }\n }\n ],\n \"pagamentos\": [\n {\n \"valor\": 1\n }\n ],\n \"issuerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"serie\": 123,\n \"numero\": 123,\n \"destCPF\": \"<string>\",\n \"destNome\": \"<string>\",\n \"troco\": 1,\n \"cobranca\": {\n \"duplicatas\": [\n {\n \"vencimento\": \"<string>\",\n \"valor\": 1.01,\n \"numero\": \"<string>\"\n }\n ]\n },\n \"informacoesComplementares\": \"<string>\",\n \"resolverTributacao\": true\n}"
response = http.request(request)
puts response.read_bodyBody
application/json
Itens da nota (mínimo 1)
Minimum array length:
1Show child attributes
Show child attributes
Formas de pagamento (mínimo 1, máximo 100). Atenção: o campo é "pagamentos" (array), não "pagamento"
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
UUID do emissor (retornado por POST /v1/companies). Opcional com 1 emissor cadastrado; obrigatório com 2+
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Série da NFC-e. Ausente = série padrão do emissor
Número da NFC-e (passthrough). Ausente = alocado automaticamente pela engineAPI
CPF do consumidor final, só dígitos. Ausente = venda sem identificação
Nome do consumidor final. Ausente = "CONSUMIDOR FINAL"
Valor do troco em R$, para venda com pagamento em dinheiro (máximo 2 casas decimais)
Required range:
x >= 0NÃO SUPORTADO na NFC-e: devolve 422 COBRANCA_NAO_SUPORTADA_NFCE. NFC-e documenta venda com pagamento imediato ao consumidor final; use NF-e (modelo 55) para venda a prazo
Show child attributes
Show child attributes
Informações complementares de interesse do contribuinte, impressas no cupom
Ativa a emissão assistida (Cérebro Fiscal): resolve CSOSN e o grupo IBS/CBS de itens sem tributação manual. Requer plano com fiscalBrain + Issuer.fiscalBrainEnabled
Response
NFC-e emitida com sucesso
⌘I