Fale Whatsapp
API (v1.0)
Nota Fiscal Eletronica de consumidor
Linguagens:
GET

Request
{
    "natureza_operacao": "VENDA DENTRO DO ESTADO",
    "serie": "1",
    "numero": "1035",
    "data_emissao": "2020-10-15T03:00:00-03:00",
    "presenca_comprador": "9",
    "destinatario": {
        "cnpj": "15493535500128",
        "nome": "EMPRESA MODELO",
        "indicador_inscricao_estadual": "1",
        "inscricao_estadual": "212055510",
        "endereco": {
            "logradouro": "AVENIDA TESTE",
            "numero": "444",
            "bairro": "CENTRO",
            "codigo_municipio": "2408003",
            "nome_municipio": "Mossoro",
            "uf": "RN",
            "cep": "59653120",
            "codigo_pais": "1058",
            "nome_pais": "BRASIL",
            "telefone": "8499995555"
        }
    },
    "itens": [
        {
            "numero_item": "1",
            "codigo_produto": "000297",
            "descricao": "SAL GROSSO 50KGS",
            "codigo_ncm": "55110011",
            "cfop": "5102",
            "unidade_comercial": "SC",
            "quantidade_comercial": 10,
            "valor_unitario_comercial": "22.45",
            "valor_bruto": "224.50",
            "unidade_tributavel": "SC",
            "quantidade_tributavel": "10.00",
            "valor_unitario_tributavel": "22.45",
            "origem": "0",
            "inclui_no_total": "1",
            "imposto": {
                "valor_aproximado_tributos": 9.43,
                "icms": {
                    "situacao_tributaria": "102",
                    "modalidade_base_calculo": "3",
                    "valor_base_calculo": "0.00",
                    "modalidade_base_calculo_st": "4",
                    "aliquota_reducao_base_calculo": "0.00",
                    "aliquota": "0.00",
                    "aliquota_final": "0.00",
                    "valor": "0.00",
                    "aliquota_margem_valor_adicionado_st": "0.00",
                    "aliquota_reducao_base_calculo_st": "0.00",
                    "valor_base_calculo_st": "0.00",
                    "aliquota_st": "0.00",
                    "valor_st": "0.00"
                },
                "pis": {
                    "situacao_tributaria": "01",
                    "valor_base_calculo": 224.5,
                    "aliquota": "1.65",
                    "valor": "3.70"
                },
                "cofins": {
                    "situacao_tributaria": "01",
                    "valor_base_calculo": 224.5,
                    "aliquota": "7.60",
                    "valor": "17.06"
                }
            },
            "valor_desconto": 0,
            "valor_frete": 0,
            "valor_seguro": 0,
            "valor_outras_despesas": 0,
            "informacoes_adicionais": "Valor aproximado tributos R$: 9,43 (4,20%) Fonte: IBPT"
        }
    ],
    "frete": {
        "modalidade_frete": "0",
        "volumes": [
            {
                "quantidade": "10",
                "especie": null,
                "marca": "TESTE",
                "numero": null,
                "peso_liquido": 500,
                "peso_bruto": 500
            }
        ]
    },
    "pagamento": {
        "formas_pagamento": [
            {
                "meio_pagamento": "01",
                "valor": "224.50",
                "tipo_integracao": "2"
            }
        ]
    },
    "informacoes_adicionais_contribuinte": "PV: 3325 * Rep: DIRETO * Motorista:  * Forma Pagto: 04 DIAS * teste de observação para a nota fiscal * Valor aproximado tributos R$9,43 (4,20%) Fonte: IBPT",
    "pessoas_autorizadas": [
        {
            "cnpj": "96256273000170"
        }, {
            "cnpj": "80681257000195"
        }
    ]
}
Responses - HTTP Code 200

{
    "sucesso": true,
    "codigo": 100,
    "mensagem": "Autorizado o uso do NF-e",
    "chave": "50190813188739000110650010000012001581978549",
    "xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZ...VByb2M+", // BASE 64
    "pdf": "JVBERi0xLjMKMyAwIG9iago8PC9UeXBlIC9QYA+...GCg==", // BASE 64
    "data_hora_evento": "2019-08-30 11:25:22",
    "protocolo": "150190003925457",
    "status": "autorizado", // autorizado ou cancelado
    "numero": "1200",
    "serie": "1"
}

{
    "sucesso": true,
    "codigo": 2,
    "mensagem": "Esta emissão foi feito offline, pode deixar que iremos cuidar disso pra voce, assim que a receita estadual voltar a operar normalmente iremos enviar esse documento fiscal",
    "chave": "50190813188739000110650010000012001581978549",
    "data_hora_evento": null,
    "protocolo": null,
    "xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZ...VByb2M+", // BASE 64
    "pdf": "JVBERi0xLjMKMyAwIG9iago8PC9UeXBlIC9QYA+...GCg==" // BASE 64
}

{
    "sucesso": false,
    "codigo": CODIGO,
    "mensagem": MENSAGEM,
    "chave": "50190813188739000110650010000012001581978549"
}

{
    "sucesso": false,
    "codigo": 5001,
    "mensagem": "JSON com erros nos campos, para mais detalhes verifique a propriedade erros",
    "erros": [
        {
            "campo": "numero",
            "erro": "NULL encontrado, mas uma string é obrigatório",
            "descricao": "Número da nota fiscal. (nNF)",
            "detalhes": "1 a 9 digitos"
        }
    ]
}

{
    "sucesso": false,
    "codigo": 5002,
    "mensagem": "Erros na geração do XML, para mais detalhes verifique a propriedade erros",
    "erros": [
        {
            "campo": "destinatario.cpf",
            "erro": "[s] - Não corresponde ao padrão ^[0-9]{11}$",
            "descricao": "CPF do destinatário. Obrigatório informar CNPJ ou CPF do destinatário. (CPF)",
            "detalhes": "11 digitos"
        }
    ]
}