{"info":{"_postman_id":"685499d3-55bf-421c-8a11-d296679c36f3","name":"API - EmiteNota","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"40903931","collectionId":"685499d3-55bf-421c-8a11-d296679c36f3","publishedId":"2sBXVZpuaH","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-26T12:39:12.000Z"},"item":[{"name":"Introdução","item":[],"id":"f6aa50bd-6990-463c-ade9-8df491629b0b","description":"

Os JSONs utilizados neste contexto não contêm valores que possam incluir caracteres reservados, como aspas simples, aspas duplas, dois pontos, barras ou chaves, garantindo assim que a estrutura do próprio JSON não seja comprometida.

APLHANUMERIC = números e letras, sem caracteres especiais, exemplo: abc123
\n
TEXT = números, letras e simbolos, exemplo: abc123!@#
\n
NUMERIC = apenas números, exemplo: 0123456789
\n
BINARY = apenas 0 ou 1, exemplo: 0
\n
DECIMAL = números no formato americano com até 4 casas decimais, exemplo: 123.123, 4567
\n
LETTER = apenas letras, exemplo: abc
\n
DATETIME = data e hora no formato americano AAAA-MM-DD HH:mm:ss, exemplo: 2020-11-05 16:15:10
\n
DATE = data no formato americano AAAA-MM-DD, exemplo: 2020-11-05
\n
TIME = hora no formato americano HH:mm:ss, exemplo: 16:15:10
\n

Para utilizar a API, a URL deve ser personalizada para cada operação lembrando que a mesma tem como URL base:

URL BASE = https://DOMINIO/index.php

\n","_postman_id":"f6aa50bd-6990-463c-ade9-8df491629b0b"},{"name":"Autenticação","item":[],"id":"730c8140-cc11-41c2-b321-573fb9a4030d","description":"

Especificação em andamento

\n","_postman_id":"730c8140-cc11-41c2-b321-573fb9a4030d"},{"name":"Certificado","item":[{"name":"Importar","id":"bbe80d29-7db4-4595-a16f-8e3ce6a13722","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\":\"42868525000193\",\n \"certificado\":\"Certificado codificado em Base64\"\n}","options":{"raw":{"language":"json"}}},"url":"https://DOMINIO/index.php?rota=certificado&recurso=importarPfx","description":"

1. Importar Certificado

Essa funcionalidade realiza a importação do certificado no sistema com base no CNPJ e no certificado informados. Como retorno, o sistema fornece uma mensagem de sucesso quando a importação é concluída com êxito ou uma mensagem de erro caso ocorra alguma falha no processo.

1.1 Estrutura da Importação do Certificado

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"certificado\": \"TEXT\"\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
certificado	TEXT	Sim	Certificado digital no formato .pfx codificado em Base64

2. Regras de Validação

Estrutura do JSON:

O JSON deve conter o campo 'cnpj_emitente' preenchido. Caso contrário, será emitido o seguinte erro: O campo 'cnpj_emitente' é obrigatório;
\n
O JSON deve conter o campo do certificado preenchido e em base64. Caso contrário, será emitido o seguinte erro: Certificado informado de forma inválida ou não informado;
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Mensagem retornada pela API, contendo informações sobre o resultado do processamento da requisição

","urlObject":{"protocol":"https","path":["index.php"],"host":["DOMINIO"],"query":[{"key":"rota","value":"certificado"},{"key":"recurso","value":"importarPfx"}],"variable":[]}},"response":[{"id":"7b5514ec-5388-428c-9e03-9d06c478ac4a","name":"Importar","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\":\"42868525000193\",\n \"certificado\":\"Certificado codificado em Base64\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=certificado&recurso=importarPfx","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"certificado"},{"key":"recurso","value":"importarPfx"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": \"Certificado importado com sucesso\"\n}"}],"_postman_id":"bbe80d29-7db4-4595-a16f-8e3ce6a13722"},{"name":"Buscar","id":"c48f885e-c89a-4575-afaa-14f865b5bb61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\":\"42868525000193\",\n \"senhaCertificado\":\"123456789\",\n \"certificado\":\"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://DOMINIO/index.php?rota=certificado&recurso=buscarDadosCertificado","description":"

1. Buscar Certificado

Essa funcionalidade realiza a busca do certificado no sistema com base no CNPJ informado. Como retorno, são fornecidos os dados do certificado em formato JSON ou uma mensagem de erro, caso o certificado não tenha sido importado anteriormente ou algum campo tenha sido informado de forma inválida.

1.1 Estrutura da Busca do Certificado

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"senhaCertificado\": \"ALPHANUMERIC\", // (maxLength: 55)\n    \"certificado\": \"TEXT\"\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
senhaCertificado	ALPHANUMERIC	Sim	Senha do certificado digital, enviada de forma criptografada
certificado	TEXT	Não	Certificado digital no formato .pfx codificado em Base64

2. Regras de Validação

Estrutura do JSON:

O JSON deve conter o campo 'cnpj_emitente' preenchido. Caso contrário, será emitido o seguinte erro: O campo 'cnpj_emitente' é obrigatório;
\n
Caso a chave senhaCertificado não sejam preenchidas, será emitido o seguinte erro: Este CNPJ não possui certificado configurado! Verifique o cadastro!;
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Mensagem retornada pela API, contendo informações sobre o resultado do processamento da requisição

3.1. Detalhes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
Arquivo	Nome ou identificador do arquivo de certificado analisado
Empresa	Razão social ou nome da empresa vinculada ao certificado
País	País de emissão do certificado digital
Certificadora	Autoridade certificadora responsável pela emissão do certificado
Tipo de certificado	Tipo do certificado digital (ex.: A1, A3, e-CNPJ, e-CPF)
Fornecedora	Entidade ou empresa fornecedora do certificado
Validade	Período de validade do certificado ou data de expiração

","urlObject":{"protocol":"https","path":["index.php"],"host":["DOMINIO"],"query":[{"key":"rota","value":"certificado"},{"key":"recurso","value":"buscarDadosCertificado"}],"variable":[]}},"response":[{"id":"8aaf3f2a-4e60-4447-8489-c598c2f39518","name":"Buscar","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\":\"42868525000193\",\n \"senhaCertificado\":\"123456789\",\n \"certificado\":\"\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=certificado&recurso=buscarDadosCertificado","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"certificado"},{"key":"recurso","value":"buscarDadosCertificado"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": \"Certificado válido\",\n \"detalhes\": {\n \"Arquivo\": \"certificado.pfx\",\n \"Empresa\": \"GIUSOFT TECNOLOGIA LTDA\",\n \"País\": \"BR\",\n \"Certificadora\": \"ICP-Brasil\",\n \"Tipo de certificado\": \"42868525000193\",\n \"Fornecedora\": \"Fornecedora \",\n \"Validade\": \"30-12-2026\"\n }\n}"}],"_postman_id":"c48f885e-c89a-4575-afaa-14f865b5bb61"}],"id":"eba12228-2a61-42bd-8120-40cbe4517844","_postman_id":"eba12228-2a61-42bd-8120-40cbe4517844","description":""},{"name":"Danfe","item":[{"name":"Emissão","id":"493239d2-6ad0-49a3-9b6e-289d392cd93c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"chave\": \"35241212345678000123550010000012341000012345\",\n \"xml\": \"XML codificado em Base64\"\n}","options":{"raw":{"language":"json"}}},"url":"https://DOMINIO/index.php?rota=danfe&recurso=gerarDanfe","description":"

1. Emissão

Essa funcionalidade realiza a emissão do DANFE com base nos dados informados no body da requisição. Como retorno, é fornecido o DANFE criptografado em formato JSON ou uma mensagem de erro, caso os dados informados sejam inválidos.

1.1 Estrutura da Emissão

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"chave\": \"NUMERIC\", // (maxLength: 44)\n    \"xml\": \"TEXT\"\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
chave	NUMERIC	Sim	Chave da NFE
xml	TEXT	Sim	XML codificado em Base64

2. Regras de Validação

Estrutura do JSON:

O JSON da requisição deve conter o campo xml devidamente preenchido, contendo o XML codificado em base64. Caso contrário, o sistema retornará o erro: \"O campo 'xml' (contendo o XML em base64) é obrigatório.\"
\n
Além disso, o JSON da requisição deve conter os campos chave e cnpj_emitente preenchidos. Caso algum deles não seja informado, o sistema retornará o erro: \"Os campos 'chave' e 'cnpj_emitente' são obrigatórios (para nomear o PDF salvo).\"
\n
Após a validação do campo xml, o sistema realiza a decodificação do conteúdo em base64. Caso o valor informado não corresponda a um base64 válido, será retornado o erro:
\"O XML fornecido não é um base64 válido.\"
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Mensagem retornada pela API, contendo informações sobre o resultado do processamento da requisição

3.1. Detalhes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
pdf_base64	Conteúdo do arquivo PDF codificado em Base64

1. Carta de Correção

Essa funcionalidade realiza a emissão do danfe da carta de correção com base nos dados informados no body da requisição. Como retorno, é fornecido o danfe da carta de correção criptografado em formato JSON ou uma mensagem de erro, caso os dados informados sejam inválidos.

1.1 Estrutura da Carta de Correção

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"chave\": \"NUMERIC\", // (maxLength: 44)\n    \"xml\": \"TEXT\",\n    \"empresa\": {\n        \"razaosocial\": \"TEXT\", // (maxLength: 255)\n        \"siglaUF\": \"LETTER\", // (maxLength: 2)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cmun\": \"NUMERIC\", // (maxLength: 7)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"xPais\": \"LETTER\", // (maxLength: 255)\n        \"cUF\": \"NUMERIC\", // (maxLength: 2)\n        \"cnae\": \"NUMERIC\", // (maxLength: 7)\n        \"xmun\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"im\": \"NUMERIC\", // (maxLength: 15)\n        \"logradouro\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"complemento\": \"TEXT\", // (maxLength: 60)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"cep\": \"NUMERIC\", // (maxLength: 8)\n        \"fone\": \"TEXT\", // (maxLength: 14)\n        \"schemes\": \"ALPHANUMERIC\", // (maxLength: 20)\n        \"tpAmb\": \"NUMERIC\", // (maxLength: 1)\n        \"regime\": \"NUMERIC\", // (maxLength: 1)\n        \"versao\": \"DECIMAL\", // (maxLength: 4)\n        \"senhaCertificado\": \"ALPHANUMERIC\", // (maxLength: 255)\n        \"usarContingenciaIbsCbs\": \"BINARY\", // (maxLength: 1)\n        \"desativarImpostosAntigos\": \"BINARY\" // (maxLength: 1)\n    }\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
chave	NUMERIC	Sim	Chave da NFE
xml	TEXT	Sim	XML codificado em Base64

1.2.1 Empresa

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
razaosocial	TEXT	Sim	Razão social da empresa emissora, conforme cadastro oficial
siglaUF	LETTER	Sim	Sigla da Unidade Federativa (UF) onde a empresa está localizada
cnpj	NUMERIC	Sim	CNPJ da empresa emissora
cmun	NUMERIC	Sim	Código do município conforme tabela do IBGE
cPais	NUMERIC	Sim	Código do país conforme padrão oficial (ex.: BACEN/ISO)
xPais	LETTER	Sim	Nome do país
cUF	NUMERIC	Sim	Código numérico da Unidade Federativa (UF)
cnae	NUMERIC	Não	Código CNAE que identifica a atividade econômica principal da empresa
xmun	LETTER	Sim	Nome do município
ie	NUMERIC	Sim	Inscrição Estadual da empresa
im	NUMERIC	Não	Inscrição Municipal da empresa
logradouro	TEXT	Sim	Nome do logradouro do endereço da empresa
numero	NUMERIC	Sim	Número do endereço da empresa
complemento	TEXT	Sim	Complemento do endereço (sala, bloco, andar, etc.)
bairro	TEXT	Sim	Bairro do endereço da empresa
cep	NUMERIC	Sim	CEP do endereço da empresa
fone	TEXT	Sim	Telefone de contato da empresa
schemes	ALPHANUMERIC	Sim	Esquemas ou configurações de segurança associados ao certificado
tpAmb	NUMERIC	Sim	Tipo de ambiente de emissão (1 = Produção, 2 = Homologação)
regime	NUMERIC	Sim	Regime tributário da empresa
versao	DECIMAL	Sim	Versão do layout ou da integração utilizada
senhaCertificado	ALPHANUMERIC	Sim	Senha do certificado digital enviada de forma criptografada
usarContingenciaIbsCbs	BINARY	Não	Indica se será utilizada contingência para IBS/CBS
desativarImpostosAntigos	BINARY	Não	Indica se os impostos antigos devem ser desativados no processamento, aplicável durante a transição para o novo modelo da reforma tributária.

2. Regras de Validação

Estrutura do JSON:

O JSON da requisição deve conter o campo xml devidamente preenchido, contendo o XML codificado em base64. Caso contrário, o sistema retornará o erro: \"O campo 'xml' (contendo o XML em base64) é obrigatório.\"
\n
Além disso, o JSON da requisição deve conter os campos chave e cnpj_emitente preenchidos. Caso algum deles não seja informado, o sistema retornará o erro: \"Os campos 'chave' e 'cnpj_emitente' são obrigatórios (para nomear o PDF salvo).\"
\n
Após a validação do campo xml, o sistema realiza a decodificação do conteúdo em base64. Caso o valor informado não corresponda a um base64 válido, será retornado o erro:
\"O XML fornecido não é um base64 válido.\"
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Mensagem retornada pela API, contendo informações sobre o resultado do processamento da requisição

3.1. Detalhes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
pdf_base64	Conteúdo do arquivo PDF codificado em Base64

1. Cancelamento

Essa funcionalidade realiza a emissão do danfe de cancelamento com base nos dados informados no body da requisição. Como retorno, é fornecido o danfe de cancelamento criptografado em formato JSON ou uma mensagem de erro, caso os dados informados sejam inválidos.

1.1 Estrutura do Cancelamento

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"chave\": \"NUMERIC\", // (maxLength: 44)\n    \"xml\": \"TEXT\",\n    \"xml_cancelamento\": \"TEXT\"\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
chave	NUMERIC	Sim	Chave da NFE
xml	TEXT	Sim	XML codificado em Base64
xml_cancelamento	TEXT	Sim	XML de cancelamento codificado em Base64

2. Regras de Validação

Estrutura do JSON:

O JSON da requisição deve conter o campo xml devidamente preenchido, contendo o XML codificado em base64. Caso contrário, o sistema retornará o erro: \"O campo 'xml' (contendo o XML em base64) é obrigatório.\"
\n
Além disso, o JSON da requisição deve conter os campos chave e cnpj_emitente preenchidos. Caso algum deles não seja informado, o sistema retornará o erro: \"Os campos 'chave' e 'cnpj_emitente' são obrigatórios (para nomear o PDF salvo).\"
\n
Após a validação do campo xml, o sistema realiza a decodificação do conteúdo em base64. Caso o valor informado não corresponda a um base64 válido, será retornado o erro:
\"O XML fornecido não é um base64 válido.\"
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Mensagem retornada pela API, contendo informações sobre o resultado do processamento da requisição

3.1. Detalhes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
pdf_base64	Conteúdo do arquivo PDF codificado em Base64

1. Emissão em Lote

Essa funcionalidade realiza a emissão dos danfes em lote com base nos dados informados no body da requisição. Como retorno, é fornecido os danfes em lote criptografado em formato JSON ou uma mensagem de erro, caso os dados informados sejam inválidos.

1.1 Estrutura da Emissão em Lote

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"documentos\": [\n        {\n            \"chave\": \"NUMERIC\", // (maxLength: 44)\n            \"xml\": \"TEXT\",\n            \"tipo\": \"ALPHANUMERIC\" // (maxLength: 3)\n        }\n    ],\n    \"id_lote\": \"ALPHANUMERIC\", // (maxLength: 55)\n    \"acao\": \"ALPHANUMERIC\", // (maxLength: 55)\n    \"com_pdf\": \"BINARY\", // (maxLength: 1)\n    \"com_xml\": \"BINARY\" // (maxLength: 1)\n}\n\n

1.1.1 Estrutura da Emissão em Lote

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"documentos\": [],\n    \"id_lote\": \"ALPHANUMERIC\", // (maxLength: 55)\n    \"acao\": \"ALPHANUMERIC\", // (maxLength: 55)\n    \"com_pdf\": \"BINARY\", // (maxLength: 1)\n    \"com_xml\": \"BINARY\" // (maxLength: 1)\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
id_lote	ALPHANUMERIC	Não	Identificador único do lote para controle e rastreabilidade da operação
acao	ALPHANUMERIC	Sim	Ação a ser executada no processamento do lote (ex.: processar, finaliza)
com_pdf	BINARY	Sim	Indica se o retorno deve conter o arquivo PDF
com_xml	BINARY	Sim	Indica se o retorno deve conter o arquivo XML

1.2.1 Campo de Documentos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
chave	NUMERIC	Sim	Chave da NFE
xml	TEXT	Processar = Sim Finalizar = Não	XML codificado em Base64
tipo	ALPHANUMERIC	Sim	tipo de documento que deseja arquivar (Ex: nfe)

2. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Mensagem retornada pela API, contendo informações sobre o resultado do processamento da requisição

2.1 Descrição do campo de detalhes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Total de arquivos lidos com sucesso
erros	Total de arquivos não lidos

","urlObject":{"protocol":"https","path":["index.php"],"host":["DOMINIO"],"query":[{"key":"rota","value":"danfe"},{"key":"recurso","value":"gerarDanfeEmLote"}],"variable":[]}},"response":[{"id":"b80a1ae1-729c-495c-88af-0090d5fd64ac","name":"Emissão em Lote Inicio","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700000\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n },\n \"documentos\": [\n {\n \"chave\": \"35241212345678000123550010000012341000012345\",\n \"xml\": \"XML codificado em Base64\",\n \"tipo\": \"nfe\"\n }\n ],\n \"id_lote\": \"69444db579514\",\n \"acao\": \"finalizar\",\n \"com_pdf\": 0,\n \"com_xml\": 0\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=danfe&recurso=gerarDanfeEmLote","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"danfe"},{"key":"recurso","value":"gerarDanfeEmLote"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\"sucesso\":true,\"status\":200,\"mensagem\":\"Lote parcial processado\",\"detalhes\":{\"sucessos\":41,\"erros\":0}}"},{"id":"654228f0-9b10-4dd1-8235-5f6b4ccb3e79","name":"Emissão em Lote Fim","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"documentos\": [],\n \"id_lote\": \"694eb86155dba\",\n \"acao\": \"finalizar\",\n \"com_pdf\": 0,\n \"com_xml\": 0\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=danfe&recurso=gerarDanfeEmLote","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"danfe"},{"key":"recurso","value":"gerarDanfeEmLote"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": \"Lote finalizado\",\n \"detalhes\": {\n \"arquivo\": \"nfe20251225_133143.zip\",\n \"caminho_relativo\": \"/storage/output/15101228000226/nfe20251225_133143.zip\",\n \"total_processado\": 82\n }\n}"}],"_postman_id":"42b52ff5-9bd5-418e-9d0e-3b6e388449e9"}],"id":"f5fb51e5-43cb-4440-b751-ee8a5522a927","_postman_id":"f5fb51e5-43cb-4440-b751-ee8a5522a927","description":""},{"name":"Nfe","item":[{"name":"Emitir","id":"859ca15c-e8d8-4550-ba65-17b7c24fcdfd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"naturezaOperacao\": \"Retorno de mercadoria deposita.\",\n \"sistema\": \"GiuSoft\",\n \"informacoesAdicionais\": \"NAO INCIDENCIA DE ICMS CONF.ART.3 VI DA LEI 7.014/96 IPI SUSPENSO NOS TERMOS DO ARTIGO 43 III DO RIPI/2010\",\n \"informacoesContribuinte\": \"\",\n \"dataHoraContingencia\": \"\",\n \"modoOperacao\": 1,\n \"numeroNota\": 10,\n \"serie\": 1,\n \"finNFe\": 1,\n \"idDest\": \"2\",\n \"tipoOperacao\": 1,\n \"tPag\": 1,\n \"vPag\": 1000,\n \"cliente\": {\n \"nome\": \"GiuSoft Tecnologia Ltda\",\n \"endereco\": \"Rua Giusoft\",\n \"numero\": \"1653\",\n \"cnpj\": \"42868525000193\",\n \"cpf\": \"\",\n \"bairro\": \"Bairro ficticio\",\n \"codigoMunicipio\": \"2927408\",\n \"municipio\": \"Salvador\",\n \"ie\": \"123456789123\",\n \"uf\": \"BA\",\n \"indIEDest\": 1,\n \"cPais\": 1058,\n \"cep\": \"4270000\"\n },\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700000\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n },\n \"produtos\": [\n {\n \"codigo\": \"123456\",\n \"descricao\": \"PRODUTO NOVO TESTE\",\n \"ncm\": \"123456789\",\n \"cfop\": \"5906\",\n \"unidade\": \"KG\",\n \"quantidade\": 100,\n \"valorUnitario\": 10,\n \"impostos\": {\n \"icms\": {\n \"orig\": 0,\n \"CST\": 0,\n \"modBC\": 0,\n \"aliquota\": 4,\n \"pRedBC\": 0,\n \"vBC\": 1000,\n \"vICMSST\": 0,\n \"vICMSSTRet\": 0,\n \"pICMSST\": 0,\n \"modBCST\": 0,\n \"pMVAST\": 0,\n \"pRedBCST\": 0,\n \"vBCST\": 0,\n \"vBCFCP\": 0,\n \"pFCP\": 0,\n \"vBCFCPST\": 0,\n \"pFCPST\": 0\n },\n \"ipi\": {\n \"CST\": 99,\n \"aliquota\": 0,\n \"cEnq\": \"999\"\n },\n \"pis\": {\n \"CST\": 8,\n \"aliquota\": 0\n },\n \"cofins\": {\n \"CST\": 8,\n \"aliquota\": 0\n },\n \"ibscbs\": {\n \"CST\": \"000\",\n \"cClassTrib\": \"000001\",\n \"indDoacao\": 0,\n \"vBC\": 0,\n \"gIBSUF_pIBSUF\": 0.1,\n \"gIBSMun_pIBSMun\": 0,\n \"gCBS_pCBS\": 0.9,\n \"gIBSUF_vIBSUF\": 0.1,\n \"gIBSUF_vDevTrib\": 0,\n \"gIBSMun_vIBSMun\": 0,\n \"gIBSMun_vDevTrib\": 0,\n \"gCBS_vCBS\": 0.9,\n \"gCBS_vDevTrib\": 0\n }\n }\n }\n ],\n \"transporte\": {\n \"modalidadeFrete\": \"0\",\n \"transportadora\": {\n \"cnpj\": \"42868525000193\",\n \"cpf\": \"\",\n \"razaoSocial\": \"GiuSoft Tecnologia Ltda\",\n \"inscricaoEstadual\": \"123456789\",\n \"endereco\": \"Rua Giusoft\",\n \"municipio\": \"Salvador\",\n \"uf\": \"BA\",\n \"cep\": \"4270000\"\n },\n \"veiculo\": {\n \"placa\": \"\",\n \"uf\": \"\",\n \"rntc\": \"\"\n },\n \"volumes\": {\n \"quantidade\": 1,\n \"especie\": \"CX\",\n \"marca\": \"\",\n \"numeracao\": \"\",\n \"pesoLiquido\": \"100.00000000\",\n \"pesoBruto\": \"100.00000000\"\n }\n }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://DOMINIO/index.php?rota=nfe&recurso=enviar","description":"

1. Emitir Nfe

Essa funcionalidade realiza a emissão da NF-e com base nos dados informados no body da requisição e retorna, em formato JSON, as informações referentes ao resultado da emissão da NF-e, ou uma mensagem de erro caso ocorra uma falha no processamento.

1.1 Estrutura da Emissão da NFE

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"naturezaOperacao\": \"TEXT\",\n    \"sistema\": \"TEXT\",\n    \"informacoesAdicionais\": \"TEXT\",\n    \"informacoesContribuinte\": \"TEXT\",\n    \"dataHoraContingencia\": \"TEXT\",\n    \"modoOperacao\": \"NUMERIC\", // (maxLength: 2)\n    \"numeroNota\": \"NUMERIC\",\n    \"serie\": \"NUMERIC\", // (maxLength: 2)\n    \"finNFe\": \"NUMERIC\", // (maxLength: 2)\n    \"idDest\": \"NUMERIC\", // (maxLength: 2)\n    \"tipoOperacao\": \"NUMERIC\", // (maxLength: 2)\n    \"tPag\": \"NUMERIC\", // (maxLength: 2)\n    \"vPag\": \"DECIMAL\", // (maxLength: 15,2)\n    \"cliente\": {\n        \"nome\": \"TEXT\", // (maxLength: 60)\n        \"endereco\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cpf\": \"NUMERIC\", // (maxLength: 11)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"codigoMunicipio\": \"NUMERIC\", // (maxLength: 7)\n        \"municipio\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"uf\": \"LETTER\", // (maxLength: 2)\n        \"indIEDest\": \"NUMERIC\", // (maxLength: 1)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"cep\": \"NUMERIC\" // (maxLength: 8)\n    },\n    \"empresa\": {\n        \"razaosocial\": \"TEXT\", // (maxLength: 255)\n        \"siglaUF\": \"LETTER\", // (maxLength: 2)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cmun\": \"NUMERIC\", // (maxLength: 7)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"xPais\": \"LETTER\", // (maxLength: 255)\n        \"cUF\": \"NUMERIC\", // (maxLength: 2)\n        \"cnae\": \"NUMERIC\", // (maxLength: 7)\n        \"xmun\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"im\": \"NUMERIC\", // (maxLength: 15)\n        \"logradouro\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"complemento\": \"TEXT\", // (maxLength: 60)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"cep\": \"NUMERIC\", // (maxLength: 8)\n        \"fone\": \"TEXT\", // (maxLength: 14)\n        \"schemes\": \"ALPHANUMERIC\", // (maxLength: 20)\n        \"tpAmb\": \"NUMERIC\", // (maxLength: 1)\n        \"regime\": \"NUMERIC\", // (maxLength: 1)\n        \"versao\": \"DECIMAL\", // (maxLength: 4)\n        \"senhaCertificado\": \"ALPHANUMERIC\", // (maxLength: 255)\n        \"usarContingenciaIbsCbs\": \"BINARY\", // (maxLength: 1)\n        \"desativarImpostosAntigos\": \"BINARY\" // (maxLength: 1)\n    },\n    \"produtos\": [\n        {\n            \"codigo\": \"ALPHANUMERIC\", // (maxLength: 60)\n            \"descricao\": \"TEXT\", // (maxLength: 120)\n            \"ncm\": \"NUMERIC\", // (maxLength: 8)\n            \"cfop\": \"NUMERIC\", // (maxLength: 4)\n            \"unidade\": \"LETTER\", // (maxLength: 6)\n            \"quantidade\": \"DECIMAL\", // (maxLength: 15,4)\n            \"valorUnitario\": \"DECIMAL\", // (maxLength: 15,10)\n            \"impostos\": {\n                \"icms\": {\n                    \"orig\": \"NUMERIC\", // (maxLength: 1)\n                    \"CST\": \"NUMERIC\", // (maxLength: 2)\n                    \"modBC\": \"NUMERIC\", // (maxLength: 1)\n                    \"aliquota\": \"DECIMAL\", // (maxLength: 5,2)\n                    \"pRedBC\": \"DECIMAL\", \n                    \"vBC\": \"DECIMAL\",\n                    \"vICMSST\": \"DECIMAL\",\n                    \"vICMSSTRet\": \"DECIMAL\",\n                    \"pICMSST\": \"DECIMAL\",\n                    \"modBCST\": \"NUMERIC\",\n                    \"pMVAST\": \"DECIMAL\",\n                    \"pRedBCST\": \"DECIMAL\",\n                    \"vBCST\": \"DECIMAL\",\n                    \"vBCFCP\": \"DECIMAL\",\n                    \"pFCP\": \"DECIMAL\",\n                    \"vBCFCPST\": \"DECIMAL\",\n                    \"pFCPST\": \"DECIMAL\"\n                },\n                \"ipi\": {\n                    \"CST\": \"NUMERIC\", // (maxLength: 2)\n                    \"aliquota\": \"DECIMAL\",\n                    \"cEnq\": \"NUMERIC\" // (maxLength: 3)\n                },\n                \"pis\": {\n                    \"CST\": \"NUMERIC\", // (maxLength: 2)\n                    \"aliquota\": \"DECIMAL\"\n                },\n                \"cofins\": {\n                    \"CST\": \"NUMERIC\", // (maxLength: 2)\n                    \"aliquota\": \"DECIMAL\"\n                },\n                \"ibscbs\": {\n                    \"CST\": \"NUMERIC\", // (maxLength: 3)\n                    \"cClassTrib\": \"NUMERIC\", // (maxLength: 6)\n                    \"indDoacao\": \"BINARY\", // (maxLength: 1)\n                    \"vBC\": \"DECIMAL\",\n                    \"gIBSUF_pIBSUF\": \"DECIMAL\",\n                    \"gIBSMun_pIBSMun\": \"DECIMAL\",\n                    \"gCBS_pCBS\": \"DECIMAL\",\n                    \"gIBSUF_vIBSUF\": \"DECIMAL\",\n                    \"gIBSUF_vDevTrib\": \"DECIMAL\",\n                    \"gIBSMun_vIBSMun\": \"DECIMAL\",\n                    \"gIBSMun_vDevTrib\": \"DECIMAL\",\n                    \"gCBS_vCBS\": \"DECIMAL\",\n                    \"gCBS_vDevTrib\": \"DECIMAL\"\n                }\n            }\n        }\n    ],\n    \"transporte\": {\n        \"modalidadeFrete\": \"NUMERIC\", // (maxLength: 1)\n        \"transportadora\": {\n            \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n            \"cpf\": \"NUMERIC\", // (maxLength: 11)\n            \"razaoSocial\": \"TEXT\", // (maxLength: 60)\n            \"inscricaoEstadual\": \"NUMERIC\", // (maxLength: 14)\n            \"endereco\": \"TEXT\", // (maxLength: 60)\n            \"municipio\": \"TEXT\", // (maxLength: 60)\n            \"uf\": \"LETTER\", // (maxLength: 2)\n            \"cep\": \"NUMERIC\" // (maxLength: 8)\n        },\n        \"veiculo\": {\n            \"placa\": \"ALPHANUMERIC\", // (maxLength: 7)\n            \"uf\": \"LETTER\", // (maxLength: 2)\n            \"rntc\": \"TEXT\" // (maxLength: 20)\n        },\n        \"volumes\": {\n            \"quantidade\": \"NUMERIC\", // (maxLength: 15)\n            \"especie\": \"TEXT\", // (maxLength: 60)\n            \"marca\": \"TEXT\", // (maxLength: 60)\n            \"numeracao\": \"NUMERIC\", // (maxLength: 60)\n            \"pesoLiquido\": \"DECIMAL\", // (maxLength: 15,3)\n            \"pesoBruto\": \"DECIMAL\" // (maxLength: 15,3)\n        }\n    }\n}\n\n

2. Estrutura da Requisição

2.1 Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ do emitente (14 dígitos)
naturezaOperacao	TEXT	Sim	Natureza da operação
sistema	TEXT	Não	Nome do sistema emissor
informacoesAdicionais	TEXT	Não	Informações adicionais do DANFE
informacoesContribuinte	TEXT	Não	Informações ao contribuinte
dataHoraContingencia	DATETIME	Não	Data/hora de contingência
modoOperacao	NUMERIC	Sim	Modo de operação da NF-e
numeroNota	NUMERIC	Sim	Número da NF-e
serie	NUMERIC	Sim	Série da NF-e
finNFe	NUMERIC	Sim	Finalidade da NF-e
idDest	TEXT	Sim	Identificação do destino
tipoOperacao	BINARY	Não	Tipo de operação
tPag	NUMERIC	Sim	Tipo de pagamento
vPag	DECIMAL	Sim	Valor do pagamento

2.2 Cliente

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
nome	TEXT	Sim	Nome/Razão social
endereco	TEXT	Sim	Logradouro
numero	NUMERIC	Sim	Número
cnpj	NUMERIC	Não	CNPJ (obrigatório se pessoa jurídica)
cpf	NUMERIC	Não	CPF (obrigatório se pessoa física)
bairro	TEXT	Sim	Bairro
codigoMunicipio	NUMERIC	Sim	Código IBGE do município
municipio	LETTER	Sim	Município
ie	NUMERIC	Não	Inscrição Estadual
uf	LETTER	Sim	UF
indIEDest	NUMERIC	Sim	Indicador de Inscrição Estadual
cPais	NUMERIC	Sim	Código do país
cep	NUMERIC	Sim	CEP

2.3 Empresa (Emitente)

Campo	Tipo	Obrigatório	Descrição
razaosocial	TEXT	Sim	Razão social da empresa emissora, conforme cadastro oficial
siglaUF	LETTER	Sim	Sigla da Unidade Federativa (UF) onde a empresa está localizada
cnpj	NUMERIC	Sim	CNPJ da empresa emissora
cmun	NUMERIC	Sim	Código do município conforme tabela do IBGE
cPais	NUMERIC	Sim	Código do país conforme padrão oficial (ex.: BACEN/ISO)
xPais	LETTER	Sim	Nome do país
cUF	NUMERIC	Sim	Código numérico da Unidade Federativa (UF)
cnae	NUMERIC	Não	Código CNAE que identifica a atividade econômica principal da empresa
xmun	LETTER	Sim	Nome do município
ie	NUMERIC	Sim	Inscrição Estadual da empresa
im	NUMERIC	Não	Inscrição Municipal da empresa
logradouro	TEXT	Sim	Nome do logradouro do endereço da empresa
numero	NUMERIC	Sim	Número do endereço da empresa
complemento	TEXT	Sim	Complemento do endereço (sala, bloco, andar, etc.)
bairro	TEXT	Sim	Bairro do endereço da empresa
cep	NUMERIC	Sim	CEP do endereço da empresa
fone	TEXT	Sim	Telefone de contato da empresa
schemes	ALPHANUMERIC	Não	Esquemas ou configurações de segurança associados ao certificado
tpAmb	NUMERIC	Não	Tipo de ambiente de emissão (1 = Produção, 2 = Homologação)
regime	NUMERIC	Não	Regime tributário da empresa
versao	DECIMAL	Não	Versão do layout ou da integração utilizada
senhaCertificado	ALPHANUMERIC	Não	Senha do certificado digital enviada de forma criptografada
usarContingenciaIbsCbs	BINARY	Não	Indica se será utilizada contingência para IBS/CBS
desativarImpostosAntigos	BINARY	Não	Indica se os impostos antigos devem ser desativados no processamento, aplicável durante a transição para o novo modelo da reforma tributária.

2.4 Produtos

Cada item em produtos deve conter os seguintes campos:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
codigo	ALPHANUMERIC	Sim	Código do produto
descricao	TEXT	Sim	Descrição do produto
ncm	NUMERIC	Sim	Código NCM
cfop	NUMERIC	Sim	CFOP
unidade	LETTER	Sim	Unidade de medida
quantidade	DECIMAL	Sim	Quantidade
valorUnitario	DECIMAL	Sim	Valor unitário

2.4.1 Impostos - ICMS

Campo	Tipo	Obrigatório	Descrição
orig	NUMERIC	Sim	Origem da mercadoria
CST	NUMERIC	Sim	Código de Situação Tributária
modBC	NUMERIC	Sim	Modalidade da base de cálculo
aliquota	DECIMAL	Sim	Alíquota (%)
pRedBC	DECIMAL	Não	Percentual de redução da BC (%)
vBC	DECIMAL	Sim	Valor da base de cálculo
vICMSST	DECIMAL	Não	Valor do ICMS ST
vICMSSTRet	DECIMAL	Não	Valor do ICMS ST retido
pICMSST	DECIMAL	Não	Percentual do ICMS ST
modBCST	NUMERIC	Não	Modalidade da BC ST
pMVAST	DECIMAL	Não	Percentual da MVA ST
pRedBCST	DECIMAL	Não	Percentual de redução da BC ST
vBCST	DECIMAL	Não	Valor da base de cálculo ST
vBCFCP	DECIMAL	Não	Base de cálculo do FCP
pFCP	DECIMAL	Não	Percentual do FCP
vBCFCPST	DECIMAL	Não	Base de cálculo do FCP ST
pFCPST	DECIMAL	Não	Percentual do FCP ST

2.4.2 Impostos - IPI

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
CST	NUMERIC	Sim	Código de Situação Tributária
aliquota	DECIMAL	Sim	Alíquota (%)
cEnq	NUMERIC	Sim	Código de enquadramento legal

2.4.3 Impostos - PIS

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
CST	NUMERIC	Sim	Código de Situação Tributária
aliquota	DECIMAL	Sim	Alíquota (%)

2.4.4 Impostos - COFINS

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
CST	NUMERIC	Sim	Código de Situação Tributária
aliquota	DECIMAL	Sim	Alíquota (%)

2.4.5 Impostos - IBS/CBS

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
CST	NUMERIC	Sim	Código de Situação Tributária IBS/CBS
cClassTrib	NUMERIC	Sim	Código de classificação tributária
indDoacao	BINARY	Sim	Indicador de doação
vBC	DECIMAL	Sim	Valor da base de cálculo
gIBSUF_pIBSUF	DECIMAL	Sim	Alíquota do IBS UF
gIBSMun_pIBSMun	DECIMAL	Sim	Alíquota do IBS Municipal
gCBS_pCBS	DECIMAL	Sim	Alíquota da CBS
gIBSUF_vIBSUF	DECIMAL	Sim	Valor do IBS UF
gIBSUF_vDevTrib	DECIMAL	Não	Valor de devolução tributária IBS UF
gIBSMun_vIBSMun	DECIMAL	Sim	Valor do IBS Municipal
gIBSMun_vDevTrib	DECIMAL	Não	Valor de devolução tributária IBS Mun
gCBS_vCBS	DECIMAL	Sim	Valor da CBS
gCBS_vDevTrib	DECIMAL	Não	Valor de devolução tributária CBS

2.5 Transporte

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
modalidadeFrete	NUMERIC	Sim	Modalidade do frete

2.5.1 Transportadora

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj	NUMERIC	Não	CNPJ da transportadora
cpf	NUMERIC	Não	CPF do transportador
razaoSocial	TEXT	Não	Razão social
inscricaoEstadual	NUMERIC	Não	Inscrição Estadual
endereco	TEXT	Não	Endereço
municipio	TEXT	Não	Município
uf	LETTER	Não	UF
cep	NUMERIC	Não	CEP

2.5.2 Veículo

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
placa	ALPHANUMERIC	Não	Placa do veículo
uf	LETTER	Não	UF da placa
rntc	TEXT	Não	RNTC

2.5.3 Volumes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
quantidade	NUMERIC	Não	Quantidade de volumes
especie	TEXT	Não	Espécie dos volumes
marca	TEXT	Não	Marca dos volumes
numeracao	NUMERIC	Não	Numeração dos volumes
pesoLiquido	DECIMAL	Não	Peso líquido
pesoBruto	DECIMAL	Não	Peso bruto

4. Regras de Validação

O campo cnpj_emitente deve conter exatamente 14 dígitos válidos
\n
Deve existir ao menos um produto no array produtos
\n
O objeto impostos é obrigatório para cada produto
\n
Valores monetários não podem ser negativos
\n
O campo senhaCertificado deve corresponder à senha do certificado digital do CNPJ informado
\n
Para pessoa física, informar cpf; para pessoa jurídica, informar cnpj no objeto cliente
\n
Os códigos de município devem seguir o padrão do IBGE
\n

5. Retorno da API

5.1 Estrutura do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Indica se a operação foi bem-sucedida (true/false)
status	Código de status HTTP
mensagem	Mensagem descritiva do resultado
detalhes	Objeto contendo os dados da NF-e emitida

5.2 Detalhes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
situacao	Situação atual da NF-e após o processamento (ex.: Aprovada, Rejeitada, Cancelada)
chave	Chave de acesso da NF-e, composta por 44 dígitos numéricos
protocolo	Número do protocolo de autorização retornado pela SEFAZ
codigoSituacaoNF	Código da situação da NF-e conforme retorno da SEFAZ (ex.: 100 – Autorizado o uso da NF-e)
dataHoraRecebimento	Data e hora do recebimento da autorização da NF-e pela SEFAZ
andamento	Histórico textual das etapas do processamento e envio da NF-e
xml	Arquivo XML da NF-e codificado em Base64

","urlObject":{"protocol":"https","path":["index.php"],"host":["DOMINIO"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"enviar"}],"variable":[]}},"response":[{"id":"01444757-5b70-46b9-a7e2-eb139856f24d","name":"Emitir","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"naturezaOperacao\": \"Retorno de mercadoria deposita.\",\n \"sistema\": \"GiuSoft\",\n \"informacoesAdicionais\": \"NAO INCIDENCIA DE ICMS CONF.ART.3 VI DA LEI 7.014/96 IPI SUSPENSO NOS TERMOS DO ARTIGO 43 III DO RIPI/2010\",\n \"informacoesContribuinte\": \"\",\n \"dataHoraContingencia\": \"\",\n \"modoOperacao\": 1,\n \"numeroNota\": 10,\n \"serie\": 1,\n \"finNFe\": 1,\n \"idDest\": \"2\",\n \"tipoOperacao\": 1,\n \"tPag\": 1,\n \"vPag\": 1000,\n \"cliente\": {\n \"nome\": \"GiuSoft Tecnologia Ltda\",\n \"endereco\": \"Rua Giusoft\",\n \"numero\": \"1653\",\n \"cnpj\": \"42868525000193\",\n \"cpf\": \"\",\n \"bairro\": \"Bairro ficticio\",\n \"codigoMunicipio\": \"2927408\",\n \"municipio\": \"Salvador\",\n \"ie\": \"123456789123\",\n \"uf\": \"BA\",\n \"indIEDest\": 1,\n \"cPais\": 1058,\n \"cep\": \"4270000\"\n },\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700000\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n },\n \"produtos\": [\n {\n \"codigo\": \"123456\",\n \"descricao\": \"PRODUTO NOVO TESTE\",\n \"ncm\": \"123456789\",\n \"cfop\": \"5906\",\n \"unidade\": \"KG\",\n \"quantidade\": 100,\n \"valorUnitario\": 10,\n \"impostos\": {\n \"icms\": {\n \"orig\": 0,\n \"CST\": 0,\n \"modBC\": 0,\n \"aliquota\": 4,\n \"pRedBC\": 0,\n \"vBC\": 1000,\n \"vICMSST\": 0,\n \"vICMSSTRet\": 0,\n \"pICMSST\": 0,\n \"modBCST\": 0,\n \"pMVAST\": 0,\n \"pRedBCST\": 0,\n \"vBCST\": 0,\n \"vBCFCP\": 0,\n \"pFCP\": 0,\n \"vBCFCPST\": 0,\n \"pFCPST\": 0\n },\n \"ipi\": {\n \"CST\": 99,\n \"aliquota\": 0,\n \"cEnq\": \"999\"\n },\n \"pis\": {\n \"CST\": 8,\n \"aliquota\": 0\n },\n \"cofins\": {\n \"CST\": 8,\n \"aliquota\": 0\n },\n \"ibscbs\": {\n \"CST\": \"000\",\n \"cClassTrib\": \"000001\",\n \"indDoacao\": 0,\n \"vBC\": 0,\n \"gIBSUF_pIBSUF\": 0.1,\n \"gIBSMun_pIBSMun\": 0,\n \"gCBS_pCBS\": 0.9,\n \"gIBSUF_vIBSUF\": 0.1,\n \"gIBSUF_vDevTrib\": 0,\n \"gIBSMun_vIBSMun\": 0,\n \"gIBSMun_vDevTrib\": 0,\n \"gCBS_vCBS\": 0.9,\n \"gCBS_vDevTrib\": 0\n }\n }\n }\n ],\n \"transporte\": {\n \"modalidadeFrete\": \"0\",\n \"transportadora\": {\n \"cnpj\": \"42868525000193\",\n \"cpf\": \"\",\n \"razaoSocial\": \"GiuSoft Tecnologia Ltda\",\n \"inscricaoEstadual\": \"123456789\",\n \"endereco\": \"Rua Giusoft\",\n \"municipio\": \"Salvador\",\n \"uf\": \"BA\",\n \"cep\": \"4270000\"\n },\n \"veiculo\": {\n \"placa\": \"\",\n \"uf\": \"\",\n \"rntc\": \"\"\n },\n \"volumes\": {\n \"quantidade\": 1,\n \"especie\": \"CX\",\n \"marca\": \"\",\n \"numeracao\": \"\",\n \"pesoLiquido\": \"100.00000000\",\n \"pesoBruto\": \"100.00000000\"\n }\n }\n}\n","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=nfe&recurso=enviar","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"enviar"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": \"Autorizado o uso da NF-e\",\n \"detalhes\": {\n \"situacao\": \"Aprovada\",\n \"chave\": \"35241212345678000123550010000012341000012345\",\n \"protocolo\": \"129251001234567\",\n \"codigoSituacaoNF\": \"100\",\n \"dataHoraRecebimento\": \"2025-12-18 15:32:38\",\n \"andamento\": \"XML submetido com sucesso para processamento | Emissão normal ativado | Estrutura do XML criada com sucesso | XML assinado digitalmente com sucesso | XML validado e pronto para envio à SEFAZ | Enviando XML para a SEFAZ | O XML foi enviado com sucesso para a SEFAZ\",\n \"xml\": \"XML em Base 64\"\n }\n}"}],"_postman_id":"859ca15c-e8d8-4550-ba65-17b7c24fcdfd"},{"name":"Estornar","id":"8b689115-a384-4da5-a2fc-f1839b6411ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"naturezaOperacao\": \"999 - ESTORNO DE NFE NAO CANCELADA NO PRAZO LEGAL\",\n \"sistema\": \"Giusoft\",\n \"informacoesAdicionais\": \"\",\n \"informacoesContribuinte\": \"\",\n \"dataHoraContingencia\": \"\",\n \"modoOperacao\": 1,\n \"numeroNota\": 100,\n \"serie\": 1,\n \"finNFe\": 3,\n \"idDest\": \"1\",\n \"tipoOperacao\": 0,\n \"tPag\": 90,\n \"vPag\": 0,\n \"cliente\": {\n \"nome\": \"GiuSoft Tecnologia Ltda\",\n \"endereco\": \"Rua Giusoft\",\n \"numero\": \"1653\",\n \"cnpj\": \"42868525000193\",\n \"cpf\": \"\",\n \"bairro\": \"Bairro ficticio\",\n \"codigoMunicipio\": \"2927408\",\n \"municipio\": \"Salvador\",\n \"ie\": \"123456789123\",\n \"uf\": \"BA\",\n \"indIEDest\": 1,\n \"cPais\": 1058,\n \"cep\": \"42700000\"\n },\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700000\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n },\n \"produtos\": [\n {\n \"codigo\": \"123456\",\n \"descricao\": \"PRODUTO NOVO TESTE\",\n \"ncm\": \"123456789\",\n \"cfop\": \"5906\",\n \"unidade\": \"CX\",\n \"quantidade\": 10,\n \"valorUnitario\": 1,\n \"impostos\": {\n \"icms\": {\n \"orig\": 0,\n \"CST\": 41,\n \"modBC\": 0,\n \"aliquota\": 0,\n \"pRedBC\": 0,\n \"vBC\": 0,\n \"vICMSST\": 0,\n \"vICMSSTRet\": 0,\n \"pICMSST\": 0,\n \"modBCST\": 0,\n \"pMVAST\": 0,\n \"pRedBCST\": 0,\n \"vBCST\": 0,\n \"vBCFCP\": 0,\n \"pFCP\": 0,\n \"vBCFCPST\": 0,\n \"pFCPST\": 0\n },\n \"pis\": {\n \"CST\": 8,\n \"aliquota\": 0\n },\n \"cofins\": {\n \"CST\": 8,\n \"aliquota\": 0\n },\n \"ibscbs\": {\n \"CST\": \"000\",\n \"cClassTrib\": \"000001\",\n \"indDoacao\": 0,\n \"vBC\": 0,\n \"gIBSUF_pIBSUF\": 0.1,\n \"gIBSMun_pIBSMun\": 0,\n \"gCBS_pCBS\": 0.9,\n \"gIBSUF_vIBSUF\": 0.1,\n \"gIBSUF_vDevTrib\": 0,\n \"gIBSMun_vIBSMun\": 0,\n \"gIBSMun_vDevTrib\": 0,\n \"gCBS_vCBS\": 0.9,\n \"gCBS_vDevTrib\": 0\n }\n }\n }\n ],\n \"transporte\": {\n \"modalidadeFrete\": \"1\",\n \"transportadora\": {\n \"cnpj\": \"42868525000193\",\n \"cpf\": \"\",\n \"razaoSocial\": \"GiuSoft Tecnologia Ltda\",\n \"inscricaoEstadual\": \"123456789\",\n \"endereco\": \"Rua Giusoft\",\n \"municipio\": \"Salvador\",\n \"uf\": \"BA\",\n \"cep\": \"42700000\"\n },\n \"veiculo\": {\n \"placa\": \"\",\n \"uf\": \"\",\n \"rntc\": \"\"\n },\n \"volumes\": {\n \"quantidade\": 0,\n \"especie\": \"\",\n \"marca\": \"\",\n \"numeracao\": \"\",\n \"pesoLiquido\": 100.00000000,\n \"pesoBruto\": 100.00000000\n }\n },\n \"chaveEstorno\": \"29251215101228000145550010000019531234567890\"\n}","options":{"raw":{"language":"json"}}},"url":"https://DOMINIO/index.php?rota=nfe&recurso=estornar","description":"

1. Estorno

Essa funcionalidade realiza a emissão de uma NFe de estorno (devolução) para anular os efeitos fiscais de uma NFe que não pode mais ser cancelada (fora do prazo legal de cancelamento). O estorno é feito através da emissão de uma nova NFe com finalidade específica (finNFe = 3).

1.1 Estrutura do Estorno

{\n    \"cnpj_emitente\": \"42868525000193\",\"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"naturezaOperacao\": \"TEXT\",\n    \"sistema\": \"TEXT\",\n    \"informacoesAdicionais\": \"TEXT\",\n    \"informacoesContribuinte\": \"TEXT\",\n    \"dataHoraContingencia\": \"TEXT\",\n    \"modoOperacao\": \"NUMERIC\", // (maxLength: 2)\n    \"numeroNota\": \"NUMERIC\",\n    \"serie\": \"NUMERIC\", // (maxLength: 2)\n    \"finNFe\": \"NUMERIC\", // (maxLength: 2)\n    \"idDest\": \"NUMERIC\", // (maxLength: 2)\n    \"tipoOperacao\": \"NUMERIC\", // (maxLength: 2)\n    \"tPag\": \"NUMERIC\", // (maxLength: 2)\n    \"vPag\": \"DECIMAL\", // (maxLength: 15,2)\n    \"cliente\": {\"cliente\": {\n        \"nome\": \"TEXT\", // (maxLength: 60)\n        \"endereco\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cpf\": \"NUMERIC\", // (maxLength: 11)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"codigoMunicipio\": \"NUMERIC\", // (maxLength: 7)\n        \"municipio\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"uf\": \"LETTER\", // (maxLength: 2)\n        \"indIEDest\": \"NUMERIC\", // (maxLength: 1)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"cep\": \"NUMERIC\" // (maxLength: 8)\n    },\n    \"empresa\": {\n        \"razaosocial\": \"TEXT\", // (maxLength: 255)\n        \"siglaUF\": \"LETTER\", // (maxLength: 2)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cmun\": \"NUMERIC\", // (maxLength: 7)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"xPais\": \"LETTER\", // (maxLength: 255)\n        \"cUF\": \"NUMERIC\", // (maxLength: 2)\n        \"cnae\": \"NUMERIC\", // (maxLength: 7)\n        \"xmun\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"im\": \"NUMERIC\", // (maxLength: 15)\n        \"logradouro\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"complemento\": \"TEXT\", // (maxLength: 60)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"cep\": \"NUMERIC\", // (maxLength: 8)\n        \"fone\": \"TEXT\", // (maxLength: 14)\n        \"schemes\": \"ALPHANUMERIC\", // (maxLength: 20)\n        \"tpAmb\": \"NUMERIC\", // (maxLength: 1)\n        \"regime\": \"NUMERIC\", // (maxLength: 1)\n        \"versao\": \"DECIMAL\", // (maxLength: 4)\n        \"senhaCertificado\": \"ALPHANUMERIC\", // (maxLength: 255)\n        \"usarContingenciaIbsCbs\": \"BINARY\", // (maxLength: 1)\n        \"desativarImpostosAntigos\": \"BINARY\" // (maxLength: 1)\n    },\n    \"produtos\": [\n        {\n            \"codigo\": \"ALPHANUMERIC\", // (maxLength: 60)\n            \"descricao\": \"TEXT\", // (maxLength: 120)\n            \"ncm\": \"NUMERIC\", // (maxLength: 8)\n            \"cfop\": \"NUMERIC\", // (maxLength: 4)\n            \"unidade\": \"LETTER\", // (maxLength: 6)\n            \"quantidade\": \"DECIMAL\", // (maxLength: 15,4)\n            \"valorUnitario\": \"DECIMAL\", // (maxLength: 15,10)\n            \"impostos\": {\n                \"icms\": {\n                    \"orig\": \"NUMERIC\", // (maxLength: 1)\n                    \"CST\": \"NUMERIC\", // (maxLength: 2)\n                    \"modBC\": \"NUMERIC\", // (maxLength: 1)\n                    \"aliquota\": \"DECIMAL\", // (maxLength: 5,2)\n                    \"pRedBC\": \"DECIMAL\", \n                    \"vBC\": \"DECIMAL\",\n                    \"vICMSST\": \"DECIMAL\",\n                    \"vICMSSTRet\": \"DECIMAL\",\n                    \"pICMSST\": \"DECIMAL\",\n                    \"modBCST\": \"NUMERIC\",\n                    \"pMVAST\": \"DECIMAL\",\n                    \"pRedBCST\": \"DECIMAL\",\n                    \"vBCST\": \"DECIMAL\",\n                    \"vBCFCP\": \"DECIMAL\",\n                    \"pFCP\": \"DECIMAL\",\n                    \"vBCFCPST\": \"DECIMAL\",\n                    \"pFCPST\": \"DECIMAL\"\n                },\n                \"ipi\": {\n                    \"CST\": \"NUMERIC\", // (maxLength: 2)\n                    \"aliquota\": \"DECIMAL\",\n                    \"cEnq\": \"NUMERIC\" // (maxLength: 3)\n                },\n                \"pis\": {\n                    \"CST\": \"NUMERIC\", // (maxLength: 2)\n                    \"aliquota\": \"DECIMAL\"\n                },\n                \"cofins\": {\n                    \"CST\": \"NUMERIC\", // (maxLength: 2)\n                    \"aliquota\": \"DECIMAL\"\n                },\n                \"ibscbs\": {\n                    \"CST\": \"NUMERIC\", // (maxLength: 3)\n                    \"cClassTrib\": \"NUMERIC\", // (maxLength: 6)\n                    \"indDoacao\": \"BINARY\", // (maxLength: 1)\n                    \"vBC\": \"DECIMAL\",\n                    \"gIBSUF_pIBSUF\": \"DECIMAL\",\n                    \"gIBSMun_pIBSMun\": \"DECIMAL\",\n                    \"gCBS_pCBS\": \"DECIMAL\",\n                    \"gIBSUF_vIBSUF\": \"DECIMAL\",\n                    \"gIBSUF_vDevTrib\": \"DECIMAL\",\n                    \"gIBSMun_vIBSMun\": \"DECIMAL\",\n                    \"gIBSMun_vDevTrib\": \"DECIMAL\",\n                    \"gCBS_vCBS\": \"DECIMAL\",\n                    \"gCBS_vDevTrib\": \"DECIMAL\"\n                }\n            }\n        }\n    ],\n    \"transporte\": {\n        \"modalidadeFrete\": \"NUMERIC\", // (maxLength: 1)\n        \"transportadora\": {\n            \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n            \"cpf\": \"NUMERIC\", // (maxLength: 11)\n            \"razaoSocial\": \"TEXT\", // (maxLength: 60)\n            \"inscricaoEstadual\": \"NUMERIC\", // (maxLength: 14)\n            \"endereco\": \"TEXT\", // (maxLength: 60)\n            \"municipio\": \"TEXT\", // (maxLength: 60)\n            \"uf\": \"LETTER\", // (maxLength: 2)\n            \"cep\": \"NUMERIC\" // (maxLength: 8)\n        },\n        \"veiculo\": {\n            \"placa\": \"ALPHANUMERIC\", // (maxLength: 7)\n            \"uf\": \"LETTER\", // (maxLength: 2)\n            \"rntc\": \"TEXT\" // (maxLength: 20)\n        },\n        \"volumes\": {\n            \"quantidade\": \"NUMERIC\", // (maxLength: 15)\n            \"especie\": \"TEXT\", // (maxLength: 60)\n            \"marca\": \"TEXT\", // (maxLength: 60)\n            \"numeracao\": \"NUMERIC\", // (maxLength: 60)\n            \"pesoLiquido\": \"DECIMAL\", // (maxLength: 15,3)\n            \"pesoBruto\": \"DECIMAL\" // (maxLength: 15,3)\n        }\n    },\n    \"chaveEstorno\": \"NUMERIC\", // (maxLength: 14)\n}\n\n

2. Estrutura da Requisição

2.1 Campos

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
naturezaOperacao	TEXT	Sim	Natureza da operação (deve indicar tratar-se de estorno)
sistema	TEXT	Não	Identificação do sistema que originou a requisição
informacoesAdicionais	TEXT	Não	Informações adicionais de interesse do Fisco
informacoesContribuinte	TEXT	Não	Informações complementares de interesse do Contribuinte
dataHoraContingencia	DATETIME	Não	Data e hora de entrada em contingência (se aplicável)
modoOperacao	NUMERIC	Sim	Modo de operação (1 = Normal)
numeroNota	NUMERIC	Sim	Número da nova NFe de estorno
serie	NUMERIC	Sim	Série da NFe de estorno
finNFe	NUMERIC	Sim	Finalidade de emissão da NFe (3 = NFe de ajuste/devolução)
idDest	NUMERIC	Sim	Identificador do destino da operação (1 = Operação interna, 2 = Operação interestadual, 3 = Operação com exterior)
tipoOperacao	BINARY	Sim	Tipo de operação (0 = Entrada, 1 = Saída)
tPag	NUMERIC	Sim	Forma de pagamento (90 = Sem pagamento)
vPag	DECIMAL	Sim	Valor do pagamento (normalmente 0 para estorno)
chaveEstorno	NUMERIC	Sim	Chave de acesso da NFe original que está sendo estornada (44 caracteres)

2.2 Cliente

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
nome	TEXT	Sim	Nome ou razão social do destinatário
endereco	TEXT	Sim	Logradouro do endereço do destinatário
numero	TEXT	Sim	Número do endereço
cnpj	NUMERIC	Condicional	CNPJ do destinatário (obrigatório se pessoa jurídica)
cpf	NUMERIC	Condicional	CPF do destinatário (obrigatório se pessoa física)
bairro	TEXT	Sim	Bairro do endereço
codigoMunicipio	NUMERIC	Sim	Código do município conforme tabela IBGE
municipio	TEXT	Sim	Nome do município
ie	ALPHANUMERIC	Condicional	Inscrição Estadual do destinatário
uf	TEXT	Sim	Sigla da Unidade Federativa
indIEDest	NUMERIC	Sim	Indicador da IE do destinatário (1 = Contribuinte ICMS, 2 = Contribuinte isento, 9 = Não Contribuinte)
cPais	NUMERIC	Sim	Código do país
cep	NUMERIC	Sim	CEP do endereço

2.3 Empresa (Emitente)

Campo	Tipo	Obrigatório	Descrição
razaosocial	TEXT	Sim	Razão social da empresa emissora, conforme cadastro oficial
siglaUF	TEXT	Sim	Sigla da Unidade Federativa (UF) onde a empresa está localizada
cnpj	NUMERIC	Sim	CNPJ da empresa emissora
cmun	NUMERIC	Sim	Código do município conforme tabela do IBGE
cPais	NUMERIC	Sim	Código do país conforme padrão oficial (ex.: BACEN/ISO)
xPais	TEXT	Sim	Nome do país
cUF	NUMERIC	Sim	Código numérico da Unidade Federativa (UF)
cnae	NUMERIC	Não	Código CNAE que identifica a atividade econômica principal da empresa
xmun	TEXT	Sim	Nome do município
ie	NUMERIC	Sim	Inscrição Estadual da empresa
im	NUMERIC	Não	Inscrição Municipal da empresa
logradouro	TEXT	Sim	Nome do logradouro do endereço da empresa
numero	NUMERIC	Sim	Número do endereço da empresa
complemento	TEXT	Sim	Complemento do endereço (sala, bloco, andar, etc.)
bairro	TEXT	Sim	Bairro do endereço da empresa
cep	NUMERIC	Sim	CEP do endereço da empresa
fone	TEXT	Sim	Telefone de contato da empresa
schemes	ALPHANUMERIC	Sim	Esquemas ou configurações de segurança associados ao certificado
tpAmb	NUMERIC	Sim	Tipo de ambiente de emissão (1 = Produção, 2 = Homologação)
regime	NUMERIC	Sim	Regime tributário da empresa
versao	DECIMAL	Sim	Versão do layout ou da integração utilizada
senhaCertificado	ALPHANUMERIC	Sim	Senha do certificado digital enviada de forma criptografada
usarContingenciaIbsCbs	BINARY	Não	Indica se será utilizada contingência para IBS/CBS
desativarImpostosAntigos	BINARY	Não	Indica se os impostos antigos devem ser desativados no processamento

2.4 Produtos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
codigo	ALPHANUMERIC	Sim	Código do produto
descricao	TEXT	Sim	Descrição do produto
ncm	NUMERIC	Sim	Código NCM (Nomenclatura Comum do Mercosul)
cfop	NUMERIC	Sim	Código Fiscal de Operações e Prestações
unidade	TEXT	Sim	Unidade de medida
quantidade	DECIMAL	Sim	Quantidade comercial
valorUnitario	DECIMAL	Sim	Valor unitário de comercialização

2.4.1 Impostos - ICMS

Campo	Tipo	Obrigatório	Descrição
orig	NUMERIC	Sim	Origem da mercadoria
CST	NUMERIC	Sim	Código de Situação Tributária
modBC	NUMERIC	Sim	Modalidade da base de cálculo
aliquota	DECIMAL	Sim	Alíquota (%)
pRedBC	DECIMAL	Não	Percentual de redução da BC (%)
vBC	DECIMAL	Sim	Valor da base de cálculo
vICMSST	DECIMAL	Não	Valor do ICMS ST
vICMSSTRet	DECIMAL	Não	Valor do ICMS ST retido
pICMSST	DECIMAL	Não	Percentual do ICMS ST
modBCST	NUMERIC	Não	Modalidade da BC ST
pMVAST	DECIMAL	Não	Percentual da MVA ST
pRedBCST	DECIMAL	Não	Percentual de redução da BC ST
vBCST	DECIMAL	Não	Valor da base de cálculo ST
vBCFCP	DECIMAL	Não	Base de cálculo do FCP
pFCP	DECIMAL	Não	Percentual do FCP
vBCFCPST	DECIMAL	Não	Base de cálculo do FCP ST
pFCPST	DECIMAL	Não	Percentual do FCP ST

2.4.2 Impostos - IPI

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
CST	NUMERIC	Sim	Código de Situação Tributária
aliquota	DECIMAL	Sim	Alíquota (%)
cEnq	NUMERIC	Sim	Código de enquadramento legal

2.4.3 Impostos - PIS

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
CST	NUMERIC	Sim	Código de Situação Tributária
aliquota	DECIMAL	Sim	Alíquota (%)

2.4.4 Impostos - COFINS

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
CST	NUMERIC	Sim	Código de Situação Tributária
aliquota	DECIMAL	Sim	Alíquota (%)

2.4.5 Impostos - IBS/CBS

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
CST	NUMERIC	Sim	Código de Situação Tributária IBS/CBS
cClassTrib	NUMERIC	Sim	Código de classificação tributária
indDoacao	BINARY	Sim	Indicador de doação
vBC	DECIMAL	Sim	Valor da base de cálculo
gIBSUF_pIBSUF	DECIMAL	Sim	Alíquota do IBS UF
gIBSMun_pIBSMun	DECIMAL	Sim	Alíquota do IBS Municipal
gCBS_pCBS	DECIMAL	Sim	Alíquota da CBS
gIBSUF_vIBSUF	DECIMAL	Sim	Valor do IBS UF
gIBSUF_vDevTrib	DECIMAL	Não	Valor de devolução tributária IBS UF
gIBSMun_vIBSMun	DECIMAL	Sim	Valor do IBS Municipal
gIBSMun_vDevTrib	DECIMAL	Não	Valor de devolução tributária IBS Mun
gCBS_vCBS	DECIMAL	Sim	Valor da CBS
gCBS_vDevTrib	DECIMAL	Não	Valor de devolução tributária CBS

2.5 Transporte

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
modalidadeFrete	NUMERIC	Sim	Modalidade do frete

2.5.1 Transportadora

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj	NUMERIC	Não	CNPJ da transportadora
cpf	NUMERIC	Não	CPF do transportador
razaoSocial	TEXT	Não	Razão social
inscricaoEstadual	NUMERIC	Não	Inscrição Estadual
endereco	TEXT	Não	Endereço
municipio	TEXT	Não	Município
uf	LETTER	Não	UF
cep	NUMERIC	Não	CEP

2.5.2 Veículo

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
placa	ALPHANUMERIC	Não	Placa do veículo
uf	LETTER	Não	UF da placa
rntc	TEXT	Não	RNTC

2.5.3 Volumes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
quantidade	NUMERIC	Não	Quantidade de volumes
especie	TEXT	Não	Espécie dos volumes
marca	TEXT	Não	Marca dos volumes
numeracao	NUMERIC	Não	Numeração dos volumes
pesoLiquido	DECIMAL	Não	Peso líquido
pesoBruto	DECIMAL	Não	Peso bruto

2. Regras de Validação

Estrutura do JSON:

O JSON da requisição deve conter o campo chaveEstorno devidamente preenchido, contendo a chave de acesso completa (44 caracteres) da NFe original que está sendo estornada. Caso contrário, o sistema retornará o erro: \"O campo 'chaveEstorno' é obrigatório.\"
\n
O campo finNFe deve ser obrigatoriamente 3 (NFe de ajuste/devolução) para caracterizar o estorno. Caso contrário, o sistema retornará erro.
\n
O campo tipoOperacao deve ser invertido em relação à nota original:
\n
- Se a nota original foi de saída (1), o estorno deve ser de entrada (0)
  \n
- Se a nota original foi de entrada (0), o estorno deve ser de saída (1)
  \n
\n
Os produtos devem ser os mesmos da NFe original, com as mesmas quantidades e valores
\n
O CFOP deve ser apropriado para operação de devolução/estorno
\n
A natureza da operação deve indicar claramente que se trata de estorno
\n
O certificado digital deve estar previamente configurado para o CNPJ informado
\n
A NFe original deve existir e estar autorizada pela SEFAZ
\n

Validações da SEFAZ:

A chave de acesso da NFe original deve ser válida e estar registrada
\n
Os dados fiscais devem estar corretos conforme legislação vigente
\n
O CFOP utilizado deve ser compatível com operação de devolução
\n
A numeração da NFe de estorno deve seguir a sequência normal do emitente
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Mensagem retornada pela API, contendo informações sobre o resultado do processamento

3.1. Detalhes do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
situacao	Situação da NFe de estorno (Aprovada, Rejeitada, etc.)
chave	Chave de acesso da NFe de estorno autorizada (44 caracteres)
protocolo	Número do protocolo de autorização da NFe de estorno
codigoSituacaoNF	Código da situação da NFe retornado pela SEFAZ (100 = Autorizada)
dataHoraRecebimento	Data e hora do recebimento/autorização pela SEFAZ
andamento	Descrição detalhada do processamento da NFe de estorno
xml	XML completo da NFe de estorno autorizada, codificado em Base64

4. Códigos de Retorno da SEFAZ

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descrição
100	Autorizado o uso da NF-e
110	Uso Denegado
204	Rejeição: Duplicidade de NF-e
301	Rejeição: Uso Denegado: Irregularidade fiscal do emitente
302	Rejeição: Uso Denegado: Irregularidade fiscal do destinatário
539	Rejeição: CNPJ do destinatário não habilitado para NF-e

\n","urlObject":{"protocol":"https","path":["index.php"],"host":["DOMINIO"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"estornar"}],"variable":[]}},"response":[{"id":"550da9b3-f7bd-4b6d-b706-0dd2dd2cea2f","name":"Estornar","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"naturezaOperacao\": \"999 - ESTORNO DE NFE NAO CANCELADA NO PRAZO LEGAL\",\n \"sistema\": \"Giusoft\",\n \"informacoesAdicionais\": \"\",\n \"informacoesContribuinte\": \"\",\n \"dataHoraContingencia\": \"\",\n \"modoOperacao\": 1,\n \"numeroNota\": 100,\n \"serie\": 1,\n \"finNFe\": 3,\n \"idDest\": \"1\",\n \"tipoOperacao\": 0,\n \"tPag\": 90,\n \"vPag\": 0,\n \"cliente\": {\n \"nome\": \"GiuSoft Tecnologia Ltda\",\n \"endereco\": \"Rua Giusoft\",\n \"numero\": \"1653\",\n \"cnpj\": \"42868525000193\",\n \"cpf\": \"\",\n \"bairro\": \"Bairro ficticio\",\n \"codigoMunicipio\": \"2927408\",\n \"municipio\": \"Salvador\",\n \"ie\": \"123456789123\",\n \"uf\": \"BA\",\n \"indIEDest\": 1,\n \"cPais\": 1058,\n \"cep\": \"42700000\"\n },\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700000\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n },\n \"produtos\": [\n {\n \"codigo\": \"123456\",\n \"descricao\": \"PRODUTO NOVO TESTE\",\n \"ncm\": \"123456789\",\n \"cfop\": \"5906\",\n \"unidade\": \"CX\",\n \"quantidade\": 10,\n \"valorUnitario\": 1,\n \"impostos\": {\n \"icms\": {\n \"orig\": 0,\n \"CST\": 41,\n \"modBC\": 0,\n \"aliquota\": 0,\n \"pRedBC\": 0,\n \"vBC\": 0,\n \"vICMSST\": 0,\n \"vICMSSTRet\": 0,\n \"pICMSST\": 0,\n \"modBCST\": 0,\n \"pMVAST\": 0,\n \"pRedBCST\": 0,\n \"vBCST\": 0,\n \"vBCFCP\": 0,\n \"pFCP\": 0,\n \"vBCFCPST\": 0,\n \"pFCPST\": 0\n },\n \"pis\": {\n \"CST\": 8,\n \"aliquota\": 0\n },\n \"cofins\": {\n \"CST\": 8,\n \"aliquota\": 0\n },\n \"ibscbs\": {\n \"CST\": \"000\",\n \"cClassTrib\": \"000001\",\n \"indDoacao\": 0,\n \"vBC\": 0,\n \"gIBSUF_pIBSUF\": 0.1,\n \"gIBSMun_pIBSMun\": 0,\n \"gCBS_pCBS\": 0.9,\n \"gIBSUF_vIBSUF\": 0.1,\n \"gIBSUF_vDevTrib\": 0,\n \"gIBSMun_vIBSMun\": 0,\n \"gIBSMun_vDevTrib\": 0,\n \"gCBS_vCBS\": 0.9,\n \"gCBS_vDevTrib\": 0\n }\n }\n }\n ],\n \"transporte\": {\n \"modalidadeFrete\": \"1\",\n \"transportadora\": {\n \"cnpj\": \"42868525000193\",\n \"cpf\": \"\",\n \"razaoSocial\": \"GiuSoft Tecnologia Ltda\",\n \"inscricaoEstadual\": \"123456789\",\n \"endereco\": \"Rua Giusoft\",\n \"municipio\": \"Salvador\",\n \"uf\": \"BA\",\n \"cep\": \"42700000\"\n },\n \"veiculo\": {\n \"placa\": \"\",\n \"uf\": \"\",\n \"rntc\": \"\"\n },\n \"volumes\": {\n \"quantidade\": 0,\n \"especie\": \"\",\n \"marca\": \"\",\n \"numeracao\": \"\",\n \"pesoLiquido\": 100.00000000,\n \"pesoBruto\": 100.00000000\n }\n },\n \"chaveEstorno\": \"29251215101228000145550010000019531234567890\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=nfe&recurso=estornar","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"estornar"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": \"Autorizado o uso da NF-e\",\n \"detalhes\": {\n \"situacao\": \"Aprovada\",\n \"chave\": \"29251215101228000145550010000019531234567890\",\n \"protocolo\": \"129252001234567\",\n \"codigoSituacaoNF\": \"100\",\n \"dataHoraRecebimento\": \"2025-12-17 08:31:27\",\n \"andamento\": \"XML submetido com sucesso para processamento| Emissu00e3o normal ativado|Estrutura do XML criada com sucesso|XML assinado digitalmente com sucesso|XML validado e pronto para envio a SEFAZ|Enviando XML para a SEFAZ|O XML foi enviado com sucesso para a SEFAZ\",\n \"xml\": \"XML em base 64\"\n }\n}"}],"_postman_id":"8b689115-a384-4da5-a2fc-f1839b6411ce"},{"name":"Cancelar","id":"41eb93d9-2eb5-4b34-bcb1-c80e30405768","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"chave\": \"35241212345678000123550010000012341000012345\",\n \"protocolo\": \"12925100123456789\",\n \"justificativa\": \"TESTE DE CANCELAMENTO\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2930321\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"123456\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro fictício\",\n \"cep\": \"43700000\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://DOMINIO/index.php?rota=nfe&recurso=cancelar","description":"

1. Cancelamento

Essa funcionalidade realiza o cancelamento de uma NFe previamente autorizada, registrando o evento de cancelamento na SEFAZ. Como retorno, é fornecido o XML do evento de cancelamento codificado em Base64 ou uma mensagem de erro, caso os dados informados sejam inválidos.

1.1 Estrutura do Cancelamento

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"chave\": \"NUMERIC\", // (maxLength: 44)\n    \"protocolo\": \"NUMERIC\", // (maxLength: 15)\n    \"justificativa\": \"TEXT\", // (maxLength: 255)\n    \"empresa\": {\n        \"razaosocial\": \"TEXT\", // (maxLength: 255)\n        \"siglaUF\": \"LETTER\", // (maxLength: 2)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cmun\": \"NUMERIC\", // (maxLength: 7)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"xPais\": \"LETTER\", // (maxLength: 255)\n        \"cUF\": \"NUMERIC\", // (maxLength: 2)\n        \"cnae\": \"NUMERIC\", // (maxLength: 7)\n        \"xmun\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"im\": \"NUMERIC\", // (maxLength: 15)\n        \"logradouro\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"complemento\": \"TEXT\", // (maxLength: 60)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"cep\": \"NUMERIC\", // (maxLength: 8)\n        \"fone\": \"TEXT\", // (maxLength: 14)\n        \"schemes\": \"ALPHANUMERIC\", // (maxLength: 20)\n        \"tpAmb\": \"NUMERIC\", // (maxLength: 1)\n        \"regime\": \"NUMERIC\", // (maxLength: 1)\n        \"versao\": \"DECIMAL\", // (maxLength: 4)\n        \"senhaCertificado\": \"ALPHANUMERIC\", // (maxLength: 255)\n        \"usarContingenciaIbsCbs\": \"BINARY\", // (maxLength: 1)\n        \"desativarImpostosAntigos\": \"BINARY\" // (maxLength: 1)\n    }\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
chave	NUMERIC	Sim	Chave de acesso da NFe a ser cancelada (44 caracteres)
protocolo	NUMERIC	Sim	Número do protocolo de autorização da NFe
justificativa	TEXT	Sim	Justificativa do cancelamento (mínimo 15 caracteres)

1.2.1 Empresa

Campo	Tipo	Obrigatório	Descrição
razaosocial	TEXT	Sim	Razão social da empresa emissora, conforme cadastro oficial
siglaUF	LETTER	Sim	Sigla da Unidade Federativa (UF) onde a empresa está localizada
cnpj	NUMERIC	Sim	CNPJ da empresa emissora
cmun	NUMERIC	Sim	Código do município conforme tabela do IBGE
cPais	NUMERIC	Sim	Código do país conforme padrão oficial (ex.: BACEN/ISO)
xPais	LETTER	Sim	Nome do país
cUF	NUMERIC	Sim	Código numérico da Unidade Federativa (UF)
cnae	NUMERIC	Não	Código CNAE que identifica a atividade econômica principal da empresa
xmun	LETTER	Sim	Nome do município
ie	NUMERIC	Sim	Inscrição Estadual da empresa
im	NUMERIC	Não	Inscrição Municipal da empresa
logradouro	TEXT	Sim	Nome do logradouro do endereço da empresa
numero	NUMERIC	Sim	Número do endereço da empresa
complemento	TEXT	Sim	Complemento do endereço (sala, bloco, andar, etc.)
bairro	TEXT	Sim	Bairro do endereço da empresa
cep	NUMERIC	Sim	CEP do endereço da empresa
fone	ALPHANUMERIC	Sim	Telefone de contato da empresa
schemes	ALPHANUMERIC	Sim	Esquemas ou configurações de segurança associados ao certificado
tpAmb	NUMERIC	Sim	Tipo de ambiente de emissão (1 = Produção, 2 = Homologação)
regime	NUMERIC	Sim	Regime tributário da empresa
versao	DECIMAL	Sim	Versão do layout ou da integração utilizada
senhaCertificado	ALPHANUMERIC	Sim	Senha do certificado digital enviada de forma criptografada
usarContingenciaIbsCbs	BINARY	Não	Indica se será utilizada contingência para IBS/CBS
desativarImpostosAntigos	BINARY	Não	Indica se os impostos antigos devem ser desativados no processamento, aplicável durante a transição para o novo modelo da reforma tributária.

2. Regras de Validação

Estrutura do JSON:

O JSON da requisição deve conter o campo chave devidamente preenchido, contendo a chave de acesso da NFe a ser cancelada (44 caracteres). Caso contrário, o sistema retornará o erro: \"O campo 'chave' é obrigatório.\"
\n
O JSON da requisição deve conter o campo protocolo preenchido com o número do protocolo de autorização da NFe. Caso não seja informado, o sistema retornará o erro: \"O campo 'protocolo' é obrigatório.\"
\n
O JSON da requisição deve conter o campo justificativa preenchido com no mínimo 15 caracteres. Caso contrário, o sistema retornará o erro: \"A justificativa deve conter no mínimo 15 caracteres.\"
\n
O certificado digital deve estar previamente configurado para o CNPJ informado. Caso contrário, será retornado o erro: \"Este CNPJ não possui certificado configurado! Verifique o cadastro!\"
\n
A NFe deve estar previamente autorizada pela SEFAZ. Caso contrário, o sistema retornará erro informando que a NFe não foi encontrada ou não está autorizada.
\n
O cancelamento deve ser realizado dentro do prazo legal (geralmente 24 horas após a autorização). Após este prazo, o sistema retornará o erro com código 539: \"Cancelamento fora do prazo.\"
\n

Validações da SEFAZ:

A NFe não pode estar previamente cancelada (código 218)
\n
Não pode haver duplicidade de evento de cancelamento (código 573)
\n
NFe denegada não pode ser cancelada (código 225)
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Objeto contendo informações sobre o resultado do processamento da requisição

3.1. Detalhes do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
success	Indicador booleano de sucesso da operação de cancelamento
mensagem	Mensagem descritiva retornada pela SEFAZ sobre o resultado do cancelamento
codigo	Código de retorno da SEFAZ (135 = Evento registrado e vinculado à NF-e)
protocolo	Número do protocolo do evento de cancelamento gerado pela SEFAZ
xml_cancelamento	XML do evento de cancelamento codificado em Base64

4. Códigos de Retorno da SEFAZ

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descrição
135	Evento registrado e vinculado à NF-e
218	Rejeição: NF-e já está cancelada
225	Rejeição: NF-e denegada não pode ser cancelada
539	Rejeição: Cancelamento fora do prazo permitido
573	Rejeição: Duplicidade de Evento

","urlObject":{"protocol":"https","path":["index.php"],"host":["DOMINIO"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"cancelar"}],"variable":[]}},"response":[{"id":"b3ba0089-6788-4ad1-9dee-b8ef1e312b1b","name":"Cancelar","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"chave\": \"35241212345678000123550010000012341000012345\",\n \"protocolo\": \"12925100123456789\",\n \"justificativa\": \"TESTE DE CANCELAMENTO\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2930321\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"123456\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro fictício\",\n \"cep\": \"43700000\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}\n","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=nfe&recurso=cancelar","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"cancelar"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": {\n \"success\": true,\n \"mensagem\": \"Evento registrado e vinculado a NF-e\",\n \"codigo\": \"135\",\n \"protocolo\": \"1292510001234567\",\n \"xml_cancelamento\": \"XML em Base 64\"\n }\n}"}],"_postman_id":"41eb93d9-2eb5-4b34-bcb1-c80e30405768"},{"name":"Inutilizar","id":"37d3f3c1-7b9c-40de-bdf8-1a06a87705ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"serie\": 1,\n \"numero_inicial\": 1875,\n \"numero_final\": 1875,\n \"justificativa\": \"Numeracao nao utilizada devido a erro no sistema\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://DOMINIO/index.php?rota=nfe&recurso=inutilizar","description":"

1. Inutilização

Essa funcionalidade realiza a inutilização de numeração de NFe que não foi utilizada, registrando o evento na SEFAZ. A inutilização é utilizada quando há uma quebra de sequência na numeração das notas fiscais. Como retorno, é fornecido o protocolo de inutilização ou uma mensagem de erro, caso os dados informados sejam inválidos.

1.1 Estrutura da Inutilização

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"serie\": \"NUMERIC\", // (maxLength: 2)\n    \"numero_inicial\": \"NUMERIC\",\n    \"numero_final\": \"NUMERIC\",\n    \"justificativa\": \"TEXT\", // (maxLength: 255)\n    \"empresa\": {\n        \"razaosocial\": \"TEXT\", // (maxLength: 255)\n        \"siglaUF\": \"LETTER\", // (maxLength: 2)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cmun\": \"NUMERIC\", // (maxLength: 7)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"xPais\": \"LETTER\", // (maxLength: 255)\n        \"cUF\": \"NUMERIC\", // (maxLength: 2)\n        \"cnae\": \"NUMERIC\", // (maxLength: 7)\n        \"xmun\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"im\": \"NUMERIC\", // (maxLength: 15)\n        \"logradouro\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"complemento\": \"TEXT\", // (maxLength: 60)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"cep\": \"NUMERIC\", // (maxLength: 8)\n        \"fone\": \"TEXT\", // (maxLength: 14)\n        \"schemes\": \"ALPHANUMERIC\", // (maxLength: 20)\n        \"tpAmb\": \"NUMERIC\", // (maxLength: 1)\n        \"regime\": \"NUMERIC\", // (maxLength: 1)\n        \"versao\": \"DECIMAL\", // (maxLength: 4)\n        \"senhaCertificado\": \"ALPHANUMERIC\", // (maxLength: 255)\n        \"usarContingenciaIbsCbs\": \"BINARY\", // (maxLength: 1)\n        \"desativarImpostosAntigos\": \"BINARY\" // (maxLength: 1)\n    }\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
serie	NUMERIC	Sim	Série da NFe a ser inutilizada
numero_inicial	NUMERIC	Sim	Número inicial da faixa de numeração a ser inutilizada
numero_final	NUMERIC	Sim	Número final da faixa de numeração a ser inutilizada
justificativa	TEXT	Sim	Justificativa da inutilização (mínimo 15 caracteres)

1.2.1 Empresa

Campo	Tipo	Obrigatório	Descrição
razaosocial	TEXT	Sim	Razão social da empresa emissora, conforme cadastro oficial
siglaUF	LETTER	Sim	Sigla da Unidade Federativa (UF) onde a empresa está localizada
cnpj	NUMERIC	Sim	CNPJ da empresa emissora
cmun	NUMERIC	Sim	Código do município conforme tabela do IBGE
cPais	NUMERIC	Sim	Código do país conforme padrão oficial (ex.: BACEN/ISO)
xPais	LETTER	Sim	Nome do país
cUF	NUMERIC	Sim	Código numérico da Unidade Federativa (UF)
cnae	NUMERIC	Não	Código CNAE que identifica a atividade econômica principal da empresa
xmun	LETTER	Sim	Nome do município
ie	NUMERIC	Sim	Inscrição Estadual da empresa
im	NUMERIC	Não	Inscrição Municipal da empresa
logradouro	TEXT	Sim	Nome do logradouro do endereço da empresa
numero	NUMERIC	Sim	Número do endereço da empresa
complemento	TEXT	Sim	Complemento do endereço (sala, bloco, andar, etc.)
bairro	TEXT	Sim	Bairro do endereço da empresa
cep	NUMERIC	Sim	CEP do endereço da empresa
fone	ALPHANUMERIC	Sim	Telefone de contato da empresa
schemes	ALPHANUMERIC	Sim	Esquemas ou configurações de segurança associados ao certificado
tpAmb	NUMERIC	Sim	Tipo de ambiente de emissão (1 = Produção, 2 = Homologação)
regime	NUMERIC	Sim	Regime tributário da empresa
versao	DECIMAL	Sim	Versão do layout ou da integração utilizada
senhaCertificado	ALPHANUMERIC	Sim	Senha do certificado digital enviada de forma criptografada
usarContingenciaIbsCbs	BINARY	Não	Indica se será utilizada contingência para IBS/CBS
desativarImpostosAntigos	BINARY	Não	Indica se os impostos antigos devem ser desativados no processamento, aplicável durante a transição para o novo modelo da reforma tributária.

2. Regras de Validação

Estrutura do JSON:

O JSON da requisição deve conter o campo serie preenchido com o número da série da NFe. Caso contrário, o sistema retornará o erro: \"O campo 'serie' é obrigatório.\"
\n
O JSON da requisição deve conter o campo numero_inicial preenchido com o número inicial da faixa a ser inutilizada. Caso contrário, o sistema retornará o erro: \"O campo 'numero_inicial' é obrigatório.\"
\n
O JSON da requisição deve conter o campo numero_final preenchido com o número final da faixa a ser inutilizada. Caso contrário, o sistema retornará o erro: \"O campo 'numero_final' é obrigatório.\"
\n
O campo numero_final deve ser maior ou igual ao numero_inicial. Caso contrário, o sistema retornará erro: \"O número final deve ser maior ou igual ao número inicial.\"
\n
O JSON da requisição deve conter o campo justificativa preenchido com no mínimo 15 caracteres. Caso contrário, o sistema retornará o erro: \"A justificativa deve conter no mínimo 15 caracteres.\"
\n
O certificado digital deve estar previamente configurado para o CNPJ informado. Caso contrário, será retornado o erro: \"Este CNPJ não possui certificado configurado! Verifique o cadastro!\"
\n
A faixa de numeração não pode ter sido previamente inutilizada. Caso contrário, o sistema retornará erro informando duplicidade.
\n
A faixa de numeração não pode conter números de NFe já emitidas. Caso contrário, o sistema retornará erro da SEFAZ.
\n

Validações da SEFAZ:

Não pode haver duplicidade de inutilização para a mesma faixa de numeração
\n
A série deve ser válida para o emitente
\n
A faixa de numeração não pode estar em uso (com NFe já autorizadas)
\n
A justificativa deve estar de acordo com os padrões da SEFAZ
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Mensagem retornada pela API, contendo informações sobre o resultado do processamento da requisição

3.1. Detalhes do Retorno (Sucesso)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
protocolo	Número do protocolo de inutilização gerado pela SEFAZ
codigo	Código de retorno da SEFAZ (102 = Inutilização de número homologado)
mensagem	Mensagem descritiva retornada pela SEFAZ sobre o resultado da inutilização
xml_inutilizacao	XML do evento de inutilização codificado em Base64

4. Códigos de Retorno da SEFAZ

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descrição
102	Inutilização de número homologado
206	Rejeição: Certificado Transmissor inválido
256	Rejeição: Uma NFe da faixa já está inutilizada na Base de dados da SEFAZ
563	Rejeição: Já existe pedido de Inutilização com a mesma faixa de inutilização
564	Rejeição: Série utilizada não permitida no Web Service

","urlObject":{"protocol":"https","path":["index.php"],"host":["DOMINIO"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"inutilizar"}],"variable":[]}},"response":[{"id":"9a361607-26e8-4d5b-bf8e-d054a5178b7c","name":"Inutilizar Erro","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"serie\": 1,\n \"numero_inicial\": 1875,\n \"numero_final\": 1875,\n \"justificativa\": \"Numeracao nao utilizada devido a erro no sistema\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=nfe&recurso=inutilizar","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"inutilizar"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\"statusHttp\":400,\"resposta\":\"{\"sucesso\":false,\"status\":400,\"mensagem\":\"Este CNPJ não possui certificado configurado! Verifique o cadastro!\"}\",\"erroCurl\":\"0-\"}"},{"id":"a40b486b-b6de-4587-b9c0-8531425602ef","name":"Inutilizar Sucesso","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"serie\": 1,\n \"numero_inicial\": 1875,\n \"numero_final\": 1875,\n \"justificativa\": \"Numeracao nao utilizada devido a erro no sistema\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=nfe&recurso=inutilizar","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"inutilizar"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": \"Inutilizacao de numero homologado\",\n \"detalhes\": {\n \"codigo\": \"102\",\n \"protocolo\": \"129250000265616\",\n \"xml\": \"XML convertido em base 64\"\n }\n}"}],"_postman_id":"37d3f3c1-7b9c-40de-bdf8-1a06a87705ef"},{"name":"Carta de Correção","id":"be326c09-f3f2-4488-b649-576fed79127e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"chave\": \"35241212345678000123550010000012341000012345\",\n \"correcao\": \"Teste carta de correção\",\n \"sequencial\": 1,\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2930709\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700000\",\n \"fone\": \"071 3178-7800\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://DOMINIO/index.php?rota=nfe&recurso=cartaCorrecao","description":"

1. Carta de Correção

Essa funcionalidade realiza o registro de uma Carta de Correção Eletrônica (CC-e) para corrigir erros em campos específicos de uma NFe já autorizada.

1.1 Estrutura da Carta de Correção

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"chave\": \"NUMERIC\", // (maxLength: 44)\n    \"correcao\": \"TEXT\", // (maxLength: 255)\n    \"sequencial\": \"NUMERIC\", // (maxLength: 2)\n    \"empresa\": {\n        \"razaosocial\": \"TEXT\", // (maxLength: 255)\n        \"siglaUF\": \"LETTER\", // (maxLength: 2)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cmun\": \"NUMERIC\", // (maxLength: 7)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"xPais\": \"LETTER\", // (maxLength: 255)\n        \"cUF\": \"NUMERIC\", // (maxLength: 2)\n        \"cnae\": \"NUMERIC\", // (maxLength: 7)\n        \"xmun\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"im\": \"NUMERIC\", // (maxLength: 15)\n        \"logradouro\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"complemento\": \"TEXT\", // (maxLength: 60)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"cep\": \"NUMERIC\", // (maxLength: 8)\n        \"fone\": \"TEXT\", // (maxLength: 14)\n        \"schemes\": \"ALPHANUMERIC\", // (maxLength: 20)\n        \"tpAmb\": \"NUMERIC\", // (maxLength: 1)\n        \"regime\": \"NUMERIC\", // (maxLength: 1)\n        \"versao\": \"DECIMAL\", // (maxLength: 4)\n        \"senhaCertificado\": \"ALPHANUMERIC\", // (maxLength: 255)\n        \"usarContingenciaIbsCbs\": \"BINARY\", // (maxLength: 1)\n        \"desativarImpostosAntigos\": \"BINARY\" // (maxLength: 1)\n    }\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
chave	NUMERIC	Sim	Chave de acesso da NFe a ser corrigida (44 caracteres)
correcao	TEXT	Sim	Texto da correção a ser realizada (mínimo 15 caracteres)
sequencial	NUMERIC	Sim	Número sequencial do evento de correção (1 para primeira correção, 2 para segunda, etc.)

1.2.1 Empresa

Campo	Tipo	Obrigatório	Descrição
razaosocial	TEXT	Sim	Razão social da empresa emissora, conforme cadastro oficial
siglaUF	LETTER	Sim	Sigla da Unidade Federativa (UF) onde a empresa está localizada
cnpj	NUMERIC	Sim	CNPJ da empresa emissora
cmun	NUMERIC	Sim	Código do município conforme tabela do IBGE
cPais	NUMERIC	Sim	Código do país conforme padrão oficial (ex.: BACEN/ISO)
xPais	LETTER	Sim	Nome do país
cUF	NUMERIC	Sim	Código numérico da Unidade Federativa (UF)
cnae	NUMERIC	Não	Código CNAE que identifica a atividade econômica principal da empresa
xmun	LETTER	Sim	Nome do município
ie	NUMERIC	Sim	Inscrição Estadual da empresa
im	NUMERIC	Não	Inscrição Municipal da empresa
logradouro	TEXT	Sim	Nome do logradouro do endereço da empresa
numero	NUMERIC	Sim	Número do endereço da empresa
complemento	TEXT	Sim	Complemento do endereço (sala, bloco, andar, etc.)
bairro	TEXT	Sim	Bairro do endereço da empresa
cep	NUMERIC	Sim	CEP do endereço da empresa
fone	TEXT	Sim	Telefone de contato da empresa
schemes	TEXT	Sim	Esquemas ou configurações de segurança associados ao certificado
tpAmb	NUMERIC	Sim	Tipo de ambiente de emissão (1 = Produção, 2 = Homologação)
regime	NUMERIC	Sim	Regime tributário da empresa
versao	DECIMAL	Sim	Versão do layout ou da integração utilizada
senhaCertificado	ALPHANUMERIC	Sim	Senha do certificado digital enviada de forma criptografada
usarContingenciaIbsCbs	BINARY	Não	Indica se será utilizada contingência para IBS/CBS
desativarImpostosAntigos	BINARY	Não	Indica se os impostos antigos devem ser desativados no processamento, aplicável durante a transição para o novo modelo da reforma tributária.

2. Regras de Validação

Estrutura do JSON:

O JSON da requisição deve conter o campo chave devidamente preenchido, contendo a chave de acesso da NFe a ser corrigida (44 caracteres). Caso contrário, o sistema retornará o erro: \"O campo 'chave' é obrigatório.\"
\n
O JSON da requisição deve conter o campo correcao preenchido com no mínimo 15 caracteres. Caso contrário, o sistema retornará o erro: \"O texto de correção deve conter no mínimo 15 caracteres.\"
\n
O JSON da requisição deve conter o campo sequencial preenchido com o número sequencial da correção. Para a primeira correção, usar 1; para a segunda, usar 2; e assim sucessivamente. Caso contrário, o sistema retornará o erro: \"O campo 'sequencial' é obrigatório.\"
\n
O certificado digital deve estar previamente configurado para o CNPJ informado. Caso contrário, será retornado o erro: \"Este CNPJ não possui certificado configurado! Verifique o cadastro!\"
\n
A NFe deve estar previamente autorizada pela SEFAZ. Caso contrário, o sistema retornará erro informando que a NFe não foi encontrada ou não está autorizada.
\n
A NFe não pode estar cancelada. Caso contrário, o sistema retornará erro da SEFAZ.
\n

Validações da SEFAZ:

Não pode haver duplicidade de evento com o mesmo número sequencial
\n
A NFe deve estar autorizada e não pode estar cancelada ou denegada
\n
O número sequencial deve seguir a ordem correta (1, 2, 3...)
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP
mensagem	Mensagem retornada pela API, contendo informações sobre o resultado do processamento da requisição

3.1. Detalhes do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
protocolo	Número do protocolo do evento de correção gerado pela SEFAZ
sequencial	Número sequencial da correção registrada
data_evento	Data e hora do registro do evento no formato ISO 8601 (AAAA-MM-DDTHH:mm:ss-TZ)
xml	XML do evento de Carta de Correção codificado em Base64

4. Códigos de Retorno da SEFAZ

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descrição
135	Evento registrado e vinculado à NF-e
136	Evento registrado, mas não vinculado à NF-e
218	Rejeição: NF-e já está cancelada
225	Rejeição: NF-e denegada não pode receber Carta de Correção
573	Rejeição: Duplicidade de Evento
655	Rejeição: NFe não consta na base de dados da SEFAZ

\n","urlObject":{"protocol":"https","path":["index.php"],"host":["DOMINIO"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"cartaCorrecao"}],"variable":[]}},"response":[{"id":"9aae2907-67df-4639-ae36-c4642a05f92f","name":"Carta de Correção","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"chave\": \"35241212345678000123550010000012341000012345\",\n \"correcao\": \"Teste carta de correção\",\n \"sequencial\": 1,\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2930709\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700000\",\n \"fone\": \"071 3178-7800\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://DOMINIO/index.php?rota=nfe&recurso=cartaCorrecao","protocol":"https","host":["DOMINIO"],"path":["index.php"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"cartaCorrecao"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 12:36:10 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"75"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2eJ94oJA1wt9X52Z9vBrN1%2F9RTc51D2uK%2FYbhK0XMklSRGpO%2FPGBC1qAxZw3oQuIKP%2F9%2F%2FpFnbw5jgmqdjI4VZDbJiEIa4PG%2FfCSiV61Zd3I\"}]}"},{"key":"CF-RAY","value":"9b409f4c6f65cef0-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": \"Evento registrado e vinculado a NF-e\",\n \"detalhes\": {\n \"protocolo\": \"12345678910\",\n \"sequencial\": 1,\n \"data_evento\": \"2025-12-12T17:23:34-03:00\",\n \"xml\": \"XML codificado em Base64\"\n }\n}"}],"_postman_id":"be326c09-f3f2-4488-b649-576fed79127e"},{"name":"Consultar","id":"82e489f8-a359-4f5d-a589-0ed18e51f495","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"chave\": \"35241212345678000123550010000012341000012345\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://nfe.giusoft.com.br/index.php?rota=nfe&recurso=consultar","description":"

1. Consultar Status

Essa funcionalidade realiza a consulta do status da NFE com base nos dados informados no body da requisição. Como retorno, é fornecido o status da NFE em formato JSON ou uma mensagem de erro, caso os dados informados sejam inválidos.

1.1 Estrutura da consulta de status da SEFAZ

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"chave\": \"NUMERIC\", // (maxLength: 44)\n    \"empresa\": {\n        \"razaosocial\": \"TEXT\", // (maxLength: 255)\n        \"siglaUF\": \"LETTER\", // (maxLength: 2)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cmun\": \"NUMERIC\", // (maxLength: 7)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"xPais\": \"LETTER\", // (maxLength: 255)\n        \"cUF\": \"NUMERIC\", // (maxLength: 2)\n        \"cnae\": \"NUMERIC\", // (maxLength: 7)\n        \"xmun\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"im\": \"NUMERIC\", // (maxLength: 15)\n        \"logradouro\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"complemento\": \"TEXT\", // (maxLength: 60)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"cep\": \"NUMERIC\", // (maxLength: 8)\n        \"fone\": \"TEXT\", // (maxLength: 14)\n        \"schemes\": \"ALPHANUMERIC\", // (maxLength: 20)\n        \"tpAmb\": \"NUMERIC\", // (maxLength: 1)\n        \"regime\": \"NUMERIC\", // (maxLength: 1)\n        \"versao\": \"DECIMAL\", // (maxLength: 4)\n        \"senhaCertificado\": \"ALPHANUMERIC\", // (maxLength: 255)\n        \"usarContingenciaIbsCbs\": \"BINARY\", // (maxLength: 1)\n        \"desativarImpostosAntigos\": \"BINARY\" // (maxLength: 1)\n    }\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos
chave	NUMERIC	Sim	Chave da NFE

1.2.1 Empresa

Campo	Tipo	Obrigatório	Descrição
razaosocial	TEXT	Sim	Razão social da empresa emissora, conforme cadastro oficial
siglaUF	LETTER	Sim	Sigla da Unidade Federativa (UF) onde a empresa está localizada
cnpj	NUMERIC	Sim	CNPJ da empresa emissora
cmun	NUMERIC	Sim	Código do município conforme tabela do IBGE
cPais	NUMERIC	Sim	Código do país conforme padrão oficial (ex.: BACEN/ISO)
xPais	LETTER	Sim	Nome do país
cUF	NUMERIC	Sim	Código numérico da Unidade Federativa (UF)
cnae	NUMERIC	Não	Código CNAE que identifica a atividade econômica principal da empresa
xmun	LETTER	Sim	Nome do município
ie	NUMERIC	Sim	Inscrição Estadual da empresa
im	NUMERIC	Não	Inscrição Municipal da empresa
logradouro	TEXT	Sim	Nome do logradouro do endereço da empresa
numero	NUMERIC	Sim	Número do endereço da empresa
complemento	TEXT	Sim	Complemento do endereço (sala, bloco, andar, etc.)
bairro	TEXT	Sim	Bairro do endereço da empresa
cep	NUMERIC	Sim	CEP do endereço da empresa
fone	TEXT	Sim	Telefone de contato da empresa
schemes	ALPHANUMERIC	Sim	Esquemas ou configurações de segurança associados ao certificado
tpAmb	NUMERIC	Sim	Tipo de ambiente de emissão (1 = Produção, 2 = Homologação)
regime	NUMERIC	Sim	Regime tributário da empresa
versao	DECIMAL	Sim	Versão do layout ou da integração utilizada
senhaCertificado	ALPHANUMERIC	Sim	Senha do certificado digital enviada de forma criptografada
usarContingenciaIbsCbs	BINARY	Não	Indica se será utilizada contingência para IBS/CBS
desativarImpostosAntigos	BINARY	Não	Indica se os impostos antigos devem ser desativados no processamento, aplicável durante a transição para o novo modelo da reforma tributária.

2. Regras de Validação

Estrutura do JSON:

O JSON deve conter o campo cnpj_emitente preenchido. Caso contrário, será emitido o seguinte erro: \"O campo cnpj_emitente é obrigatório\";
\n
Além disso, é obrigatório o preenchimento do campo chave. Caso não seja informado, será emitido o erro: \"O campo chave é obrigatório\";
\n

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP

3.1. Detalhes da Mensagem

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
operacional	Indica se o serviço está operacional (`true` ou `false`)
status_code	Código de status retornado pelo serviço
motivo	Mensagem descritiva informando o motivo ou situação do serviço
ambiente	Ambiente de execução da consulta (ex: Homologação ou Produção)
uf	Código da Unidade Federativa (UF) responsável pelo serviço
data_hora_consulta	Data e hora em que a consulta ao serviço foi realizada
tempo_medio_ms	Tempo médio de resposta do serviço em milissegundos (quando disponível)

","urlObject":{"protocol":"https","path":["index.php"],"host":["nfe","giusoft","com","br"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"consultar"}],"variable":[]}},"response":[{"id":"35ac18d3-e3e7-421c-8fc6-65abd1a8874a","name":"Consultar","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"chave\": \"35241212345678000123550010000012341000012345\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://nfe.giusoft.com.br/index.php?rota=nfe&recurso=consultar","protocol":"https","host":["nfe","giusoft","com","br"],"path":["index.php"],"query":[{"key":"rota","value":"nfe"},{"key":"recurso","value":"consultar"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 20:44:38 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=%2Bwro87RNrfwuFrWwWUkzyVuS%2BH%2BkT3UrPsdlpqSJ7DrrKbmfkx41suwl9SRfJIOM7rcIrIsTuFOrPrWAw9ZR1h3OOpGUdzHAyq5LFkLWrA%3D%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9b436ad6dee64b4c-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": {\n \"situacao\": \"Autorizado o uso da NF-e\",\n \"codigo\": \"100\",\n \"protocolo\": \"129252001234567\",\n \"resposta_sefaz\": {\n \"attributes\": {\n \"versao\": \"4.00\"\n },\n \"tpAmb\": \"2\",\n \"verAplic\": \"SEFAZBA_NFENW_v7.0.1\",\n \"cStat\": \"100\",\n \"xMotivo\": \"Autorizado o uso da NF-e\",\n \"cUF\": \"29\",\n \"dhRecbto\": \"2025-12-26T17:44:38-03:00\",\n \"chNFe\": \"35241212345678000123550010000012341000012345\",\n \"protNFe\": {\n \"attributes\": {\n \"versao\": \"4.00\"\n },\n \"infProt\": {\n \"attributes\": {\n \"Id\": \"NFe129252001234567\"\n },\n \"tpAmb\": \"2\",\n \"verAplic\": \"6.0\",\n \"chNFe\": \"35241212345678000123550010000012341000012345\",\n \"dhRecbto\": \"2025-12-03T17:29:06-03:00\",\n \"nProt\": \"129252001234567\",\n \"digVal\": \"7TD9+i/SyRmOB3sZiQl+hbtJ1sE=\",\n \"cStat\": \"100\",\n \"xMotivo\": \"Autorizado o uso da NF-e\"\n }\n }\n }\n }\n}"}],"_postman_id":"82e489f8-a359-4f5d-a589-0ed18e51f495"}],"id":"d8c0c313-6c7a-4bc8-8b7e-909f83cad176","_postman_id":"d8c0c313-6c7a-4bc8-8b7e-909f83cad176","description":""},{"name":"Sefaz","item":[{"name":"Consultar Status","id":"32c74537-8664-4852-8564-3cd47b0911c5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://DOMINIO/index.php?rota=sefaz&recurso=consultarStatusSefaz","description":"

1. Consultar Status

Essa funcionalidade realiza a consulta do status da sefaz com base nos dados informados no body da requisição. Como retorno, é fornecido o status da sefaz em formato JSON ou uma mensagem de erro, caso os dados informados sejam inválidos.

1.1 Estrutura da Consulta de Status da SEFAZ

{\n    \"cnpj_emitente\": \"NUMERIC\", // (maxLength: 14)\n    \"empresa\": {\n        \"razaosocial\": \"TEXT\", // (maxLength: 255)\n        \"siglaUF\": \"LETTER\", // (maxLength: 2)\n        \"cnpj\": \"NUMERIC\", // (maxLength: 14)\n        \"cmun\": \"NUMERIC\", // (maxLength: 7)\n        \"cPais\": \"NUMERIC\", // (maxLength: 4)\n        \"xPais\": \"LETTER\", // (maxLength: 255)\n        \"cUF\": \"NUMERIC\", // (maxLength: 2)\n        \"cnae\": \"NUMERIC\", // (maxLength: 7)\n        \"xmun\": \"LETTER\", // (maxLength: 60)\n        \"ie\": \"NUMERIC\", // (maxLength: 14)\n        \"im\": \"NUMERIC\", // (maxLength: 15)\n        \"logradouro\": \"TEXT\", // (maxLength: 60)\n        \"numero\": \"NUMERIC\", // (maxLength: 60)\n        \"complemento\": \"TEXT\", // (maxLength: 60)\n        \"bairro\": \"TEXT\", // (maxLength: 60)\n        \"cep\": \"NUMERIC\", // (maxLength: 8)\n        \"fone\": \"TEXT\", // (maxLength: 14)\n        \"schemes\": \"ALPHANUMERIC\", // (maxLength: 20)\n        \"tpAmb\": \"NUMERIC\", // (maxLength: 1)\n        \"regime\": \"NUMERIC\", // (maxLength: 1)\n        \"versao\": \"DECIMAL\", // (maxLength: 4)\n        \"senhaCertificado\": \"ALPHANUMERIC\", // (maxLength: 255)\n        \"usarContingenciaIbsCbs\": \"BINARY\", // (maxLength: 1)\n        \"desativarImpostosAntigos\": \"BINARY\" // (maxLength: 1)\n    }\n}\n\n

1.2 Descrição dos Campos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
cnpj_emitente	NUMERIC	Sim	CNPJ da empresa emissora, contendo 14 dígitos numéricos

1.2.1 Empresa

Campo	Tipo	Obrigatório	Descrição
razaosocial	TEXT	Sim	Razão social da empresa emissora, conforme cadastro oficial
siglaUF	LETTER	Sim	Sigla da Unidade Federativa (UF) onde a empresa está localizada
cnpj	NUMERIC	Sim	CNPJ da empresa emissora
cmun	NUMERIC	Sim	Código do município conforme tabela do IBGE
cPais	NUMERIC	Sim	Código do país conforme padrão oficial (ex.: BACEN/ISO)
xPais	LETTER	Sim	Nome do país
cUF	NUMERIC	Sim	Código numérico da Unidade Federativa (UF)
cnae	NUMERIC	Não	Código CNAE que identifica a atividade econômica principal da empresa
xmun	LETTER	Sim	Nome do município
ie	NUMERIC	Sim	Inscrição Estadual da empresa
im	NUMERIC	Não	Inscrição Municipal da empresa
logradouro	TEXT	Sim	Nome do logradouro do endereço da empresa
numero	NUMERIC	Sim	Número do endereço da empresa
complemento	TEXT	Sim	Complemento do endereço (sala, bloco, andar, etc.)
bairro	TEXT	Sim	Bairro do endereço da empresa
cep	NUMERIC	Sim	CEP do endereço da empresa
fone	TEXT	Sim	Telefone de contato da empresa
schemes	ALPHANUMERIC	Sim	Esquemas ou configurações de segurança associados ao certificado
tpAmb	NUMERIC	Sim	Tipo de ambiente de emissão (1 = Produção, 2 = Homologação)
regime	NUMERIC	Sim	Regime tributário da empresa
versao	DECIMAL	Sim	Versão do layout ou da integração utilizada
senhaCertificado	ALPHANUMERIC	Sim	Senha do certificado digital enviada de forma criptografada
usarContingenciaIbsCbs	BINARY	Não	Indica se será utilizada contingência para IBS/CBS
desativarImpostosAntigos	BINARY	Não	Indica se os impostos antigos devem ser desativados no processamento, aplicável durante a transição para o novo modelo da reforma tributária.

2. Regras de Validação

Estrutura do JSON:

O JSON deve conter o campo 'cnpj_emitente' preenchido. Caso contrário, será emitido o seguinte erro: O campo 'cnpj_emitente' é obrigatório;

3. Descrição do Retorno

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Identificador de sucesso ou falha da requisição
status	Status HTTP

3.1. Detalhes da Mensagem

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
operacional	Indica se o serviço está operacional (`true` ou `false`)
status_code	Código de status retornado pelo serviço
motivo	Mensagem descritiva informando o motivo ou situação do serviço
ambiente	Ambiente de execução da consulta (ex: Homologação ou Produção)
uf	Código da Unidade Federativa (UF) responsável pelo serviço
data_hora_consulta	Data e hora em que a consulta ao serviço foi realizada
tempo_medio_ms	Tempo médio de resposta do serviço em milissegundos (quando disponível)

","urlObject":{"protocol":"https","path":["index.php"],"host":["DOMINIO"],"query":[{"key":"rota","value":"sefaz"},{"key":"recurso","value":"consultarStatusSefaz"}],"variable":[]}},"response":[{"id":"245763c5-1828-4d55-a91e-99ce5ccdab07","name":"Consultar Status","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cnpj_emitente\": \"42868525000193\",\n \"empresa\": {\n \"razaosocial\": \"Giusoft Tecnologia LTDA\",\n \"siglaUF\": \"BA\",\n \"cnpj\": \"42868525000193\",\n \"cmun\": \"2927408\",\n \"cPais\": \"1058\",\n \"xPais\": \"BRASIL\",\n \"cUF\": \"29\",\n \"cnae\": \"\",\n \"xmun\": \"Salvador\",\n \"ie\": \"123456789\",\n \"im\": \"\",\n \"logradouro\": \"Rua Giusoft\",\n \"numero\": \"12345\",\n \"complemento\": \"Tecnologia\",\n \"bairro\": \"Bairro ficticio\",\n \"cep\": \"42700\",\n \"fone\": \"071 9999-9999\",\n \"schemes\": \"PL_010V1.30B\",\n \"tpAmb\": 2,\n \"regime\": \"3\",\n \"versao\": \"4.00\",\n \"senhaCertificado\": \"123456789\",\n \"usarContingenciaIbsCbs\": 0,\n \"desativarImpostosAntigos\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://nfe.giusoft.com.br/index.php?rota=sefaz&recurso=consultarStatusSefaz","protocol":"https","host":["nfe","giusoft","com","br"],"path":["index.php"],"query":[{"key":"rota","value":"sefaz"},{"key":"recurso","value":"consultarStatusSefaz"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Fri, 26 Dec 2025 20:06:16 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"x-powered-by","value":"PHP/8.4.15"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=liBpDgGzWAFKb2NiY9HCfgl%2BBAMt2SVsh6TcNYz9kyBOT4cz7Blq3iWwra3MzhZl6gucpaySc%2BTPUHLjWe5EONvXeuN9tuOFlHdiUll9OQ%3D%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9b4332a2a98d603d-GRU"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"sucesso\": true,\n \"status\": 200,\n \"mensagem\": {\n \"operacional\": true,\n \"status_code\": \"107\",\n \"motivo\": \"Servico em Operacao\",\n \"ambiente\": \"Homologação\",\n \"uf\": \"29\",\n \"data_hora_consulta\": \"26/12/2025 17:06:16\",\n \"tempo_medio_ms\": null\n }\n}"}],"_postman_id":"32c74537-8664-4852-8564-3cd47b0911c5"}],"id":"3fa1ddd4-3442-4b8a-b751-577c22721848","_postman_id":"3fa1ddd4-3442-4b8a-b751-577c22721848","description":""}]}