Como emitir NFC-e offline

Existes alguns cenários que devem ser bem entendidos para que o processo não fique falho, vamos aos dois casos:

1. Sefaz com lentidão, mas processou seu documento fiscal
Quando é enviado um documento fiscal por exemplo com o numero 1 e a Sefaz esta com lentidão e nos devolve um erro maior que 7000 isso indica um erro de comunicação que pode representar varias coisas, em alguns casos a Sefaz recebe o documento fiscal e o mesmo fica na fila de processamento, fazendo com que a consulta retorne uma nota ainda não processada, nesse caso iremos lhe retornar código 5023, fazendo com que seja aguardado alguns minutos para ser feito a consulta pela chave de acesso na API.

{
    "sucesso": false,
    "codigo": 7028,
    "mensagem": "Falha de Comunicação! TimeOut.",
    "chave": "50190813188739000110650010000012001581978549"
}


Nesse formato para não deixar o cliente parado e esperando a NFC-e ser autorizada, deve ser incrementado a numeração dessa NFC-e para 2 e enviado ela novamente com o grupo contingencia no payload, iremos devolver a impressão da NFC-e em contingência offline, deve ser entregue ao cliente e o processo é finalizado, assim o cliente não ira ficar esperando.

{
    "contingencia": {
        "data": "2022-05-20T10:00:00-03:00",
        "motivo": "Sefaz fora do ar"
    },
    "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_item": "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"
        }
    ]
}


Após ser feito a emissão offline deve ser utilizado a rota de processamento de NFC-e offline na API,
com isso será enviado a NFC-e número 2 para a Sefaz.
Porém com esse cenário temos um problema, pois a Sefaz pode ter autorizado a NFC-e número 1(Emissão em modo normal porém com lentidão na Sefaz) e também a NFC-e número 2(Emissão em modo offline), para resolver isso existe uma rota na API que é para Cancelamento por Substituição, aonde tem um prazo de 168 horas para fazer a substituição de NFC-e número 1 pela número 2.

2. Sefaz fora e não recebeu seu documento fiscal
Nesse cenário a NFC-e número 1 não foi recebida nem processada pela Sefaz, então deve ser incrementado o número para 2 e feito o envio offline conforme mencionado no cenário a cima.
Tendo certeza de que a NFC-e número 1 não existe na Sefaz deve ser feito a inutilização dessa numeração.

Cleiton
Desenvolvedor, backend, frontend.

Categorias

  1. Api
    Clique para ver mais
  2. NFCe
    Clique para ver mais
  3. NFe
    Clique para ver mais
  4. CTe
    Clique para ver mais
  5. NFSe
    Clique para ver mais
  6. MDFe
    Clique para ver mais
  7. Sefaz
    Clique para ver mais
  8. Receita Federal
    Clique para ver mais
  9. DFe
    Clique para ver mais
  10. Videos
    Clique para ver mais
  11. Gestão
    Clique para ver mais
  12. Webhook
    Clique para ver mais

Casos de sucesso

Parceiros que utilizam a solução Integra Notas

Depoimentos

O que nossos clientes estão falando sobre a API IntegraNotas.

"A Combinação com Linux e Php proporciona melhor qualidade e velocidade na comunicação com servidores de documentos fiscais.
Usavamos no passado APIs com outras linguagens e sistemas operacionais, nos quais ocasionavam muitos erros.
Integra Notas esta de parabéns, por ter uma estrutura de boa qualidade e um suporte rapido e qualificado."


Marcos

Marcos Desenvolvimento de Sistemas

www.marcossistemas.com.br

Marcos Desenvolvimento de Sistemas

Escolhemos utilizar a API da Integra Notas pela sua facilidade de integração via JSON, permitindo que nos concentremos nas funcionalidades essenciais para aprimorar nosso sistema e impulsionar os resultados dos clientes, além de um suporte altamente qualificado que nunca deixou a nossa equipe dev na mão.


Thiago Lopes

DaringTech

www.daringtech.com.br

DaringTech

Utilizávamos outro serviço para envio da NFSe, mas o problema estava no suporte.
Precisava eu mesmo entrar em contato com provedor da nota de serviços de cada prefeitura. Isto estava me tomando muito tempo.
Então, procurando um novo serviço de envio, encontrei o Integra Notas.
A intergração é feita por API e está me ajudando bastante, tanto no suporte do envio dos dados, quanto no suporte para o desenvolvimento da ferramenta para o acesso.
Sem contar que a Integra Notas tem uma página específica para cada softhouse onde podemos acompanhar a emissão e os erros que estão acontecendo, fica tudo disponível na nuvem.


Cleomar

Servi Soft

www.ssfacil.com.br

Servi Soft

Optei pela utilização da API para concentrar-me no desenvolvimento de novas funcionalidades voltadas aos nossos clientes,
sem a necessidade de dedicar tempo às atualizações e regulamentações da SEFAZ. Dessa forma, é possível otimizar esforços
naquilo que realmente importa para atender melhor às necessidades dos clientes.


Jeferson

eBit Sistemas

www.ebitsistemas.com.br

eBit Sistemas

Questões contábeis podem ser complexas, um grande diferencial do Integra Notas é o suporte.
Comparado a outras empresas, foi o suporte mais ágil e mais solícito que tivemos.


Marcelo

Ágil.net

www.agil.net

Ágil.net