Pular para o conteúdo principal

Envio, consulta, impressão e cancelamento de uma nota utilizando Plugnotas com o NeverStop

Equipe TecnoSpeed
Atualizado

O fluxo da emissão será realizado como de costume, com requisições HTTP, alterando o endpoint para localhost.

 

Segue abaixo as rotas que podem ser utilizadas:

 

Envio

No aplicativo NeverStop, antes de qualquer envio, será necessário realizar as configurações do cnpj emitente e token da Software House. Posteriormente, clique em "Salvar" e depois "Ativar", para que dê início na execução do mesmo para capturar as notas.

Deve-se utilizar o método 'POST' com o seguinte modelo de URL: http://localhost:8082/nfce

O JSON deve ser enviado no body da requisição, como na imagem abaixo:

EnvioContingencia.png

 

[Post]/nfce
Exemplo de envio: 
[
    {
        "idIntegracao" : 146146146113,
        "natureza" : "VENDA",
        "emitente" : {
            "cpfCnpj" : "cnpjAqui"
        },
        "serie": 457,
        "itens" : [
            {
                "codigo" : "54752",
                "descricao" : "LEITE UHT ITALAC ZERO LACTOSE SEMIDESNATADO C/ TAMPA 1L - UN",
                "codigoBarras" : "",
                "codigoBarrasTributavel" : "",
                "ncm" : "04012010",
                "cfop" : "5405",
                "valorUnitario" : {
                    "comercial" : 7.99,
                    "tributavel" : 7.99
                },
                "quantidade" : {
                    "comercial" : 1,
                    "tributavel" : 1
                },
                "valor" : 7.99,
                "tributos" : {
                    "icms" : {
                        "origem" : "0",
                        "cst" : "60"
                    },
                    "pis" : {
                        "origem" : "0",
                        "cst" : "06"
                    },
                    "cofins" : {
                        "origem" : "0",
                        "cst" : "06"
                    }
                }
            }
        ],
        "pagamentos" : [
            {
                "aVista" : true,
                "meio" : "17",
                "valor" : 7.99
            }
        ],
      "responsavelTecnico" : {
        "telefone" : {
            "ddd" : "44",
            "numero" : "30379500"
        },
        "cpfCnpj" : "cnpjAqui",
        "nome" : "Tecnospeed",
        "email" : "contato@tecnospeed.com.br"
    },
        "consumidorFinal" : true,
        "tipoEmissao" : 1,
        "destinatario" : {
            "cpfCnpj" : "cnpjAqui",
            "email" : "emailAqui",
            "razaoSocial" : "Teste"
        }
    }
]

Exemplos de retornos

Normal

{
    "documents": {
        "emitente": "29062609000177",
        "idIntegracao": ""
    },
    "chave": "41230529062609000177654570000006861183138521",
    "message": "Nota(as) em processamento"
}
Contingência
{
"documents": {
"emitente": "29062609000177",
"idIntegracao": ""
},
"chave": "41230529062609000177654570000006889574198778",
"message": "Registrada como Contingência Offline"
}

 



 

Consulta

Para consultar sua nota, deve-se utilizar o método 'GET' com o seguinte modelo de URL: http://localhost:8082/nfce/{chave}/resumo . Lembrando que atualmente é possível consultar as notas somente pela chave. Em breve será liberada a opção de consultas e obtenção de retornos com o campo 'idIntegracao' .

 

[Get]/nfce/{chaveNota}/resumo

Exemplo de retorno:

{
    "numero": "684",
    "tipoEmissao": "Normal",
    "mensagem": "Autorizado o uso da NF-e",
    "valor": "7.99",
    "chave": "41230529062609000177654570000006841666485213",
    "idIntegracao": "",
    "destinatario": "99999999999",
    "emitente": "29062609000177",
    "protocolo": "141230000143567",
    "pdf": "http://localhost:8082/NFCe41230529062609000177654570000006841666485213.pdf",
    "xml": "http://localhost:8082/NFCe41230529062609000177654570000006841666485213.xml",
    "dataAutorizacao": "24-05-2023 13:05",
    "serie": "457",
    "emissao": "24-05-2023 13:05",
    "status": "CONCLUIDO"
}
 

Obtendo PDF e XML


Para obter essas informações, você vai chamar as rotas http://localhost:8082/nfce/{chave}/pdf e http://localhost:8082/nfce/{chave}/xml como 'GET' e passar como filtro, a chave da nota que nós retornamos para você na requisição de envio do json. 

Mais uma vez, afim de não termos duplicação de documentações, essa aqui é a documentação explicativa da obtenção do PDF e essa aqui é a documentação para obtenção do XML, lembrando que será necessário alterar o endpoint para localhost.

Obs:

  • Em caso de nota cancelada o PDF retornado, será atualizado com as informações do cancelamento
  • A nota emitida e consultada em modo contingência, irá retornar somente o PDF. Após sua autorização pela SEFAZ, será possível consultar seu XML.
Os retornos da consulta da nota, possuem dois campos no json, que são as URLs de requisição, prontas, para PDF e para XML. Basta pegar elas ali e disparar a requisição para o PlugNotas.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

[Get]/nfce/{chaveNota}/pdf

Exemplo de retorno:

xRtimage.png
Não encontrada
{
 "error": {
"data": {
"chaveNota": "41230529062609000177654570000006871574198779"
},
"message": "Não localizamos qualquer NFCe com os parâmetros informados"
}

 

XML

[Get]/nfce/{chaveNota}/xml

Exemplo de retorno:

mceclip0__1_.png
Não encontrada
{
 "error": {
"data": {
"chaveNota": "41230529062609000177654570000006871574198779"
},
"message": "Não localizamos qualquer NFCe com os parâmetros informados"
}

Em contingência

{
  "error": {
     "data": {
     "chaveNota": "41230529062609000177654570000006891646687704"
    },
   "message": "Não é possivel consultar o xml destinatário em modo off-line"
  }
}

 

 

Cancelamento

O cancelamento da NFC-e também é assíncrono e também é solicitado através da chave que geramos para essa nota. 

Você deve disparar uma requisição do tipo 'POST' e a chave da nota na URL http://localhost:8082/nfce/{chave}/cancelamento .  Aqui a documentação para solicitar o cancelamento.

 

[Post]/nfce/{chaveNota}/cancelamento

Exemplo de envio:

{
 "justificativa": "Teste cancelamento"
}
Exemplo de retorno:
{
"message": "Cancelamento em processamento"
}

 

Status Cancelamento

[Get]/nfce/{chaveNota}/cancelamento/status

Exemplo de retorno:

Concluído

{
 "data": {
"date": "2023-05-23T17:55:34-03:00",
"protocolo": "141230000142886",
"xml": "http://localhost:8082/NFCe41230529062609000177654570000006761282016860.xml",
"respostaSefaz": "Evento registrado e vinculado a NF-e",
"cStat": "135",
"status": "CONCLUIDO"
},
"message": "Solicitação de cancelamento processada"
}
Rejeitado
{
"data": {
"date": "2023-05-31T17:32:48-03:00",
"protocolo": "",
"xml": "http://localhost:8082/NFCe41230529062609000177654570000006871574198775.xml",
"respostaSefaz": "NFC-e autorizada ha mais de . 30 minutos",
"cStat": "501",
"status": "REJEITADO"
},
"message": "Solicitação de cancelamento processada"
}
Não encontrada
{
 "error": {
"data": {
"chaveNota": "41230529062609000177654570000006871574198779"
},
"message": "Não localizamos qualquer NFCe com os parâmetros informados"
}

 


Para saber se o cancelamento foi efetivado com sucesso, você pode consultar esse protocolo retornado ou então aguardar o WebHook te notificar.

Obs: Por padrão, o cancelamento de uma NFC-e pode ser feito em até 30 (trinta) minutos a partir da hora de autoriozação dela. Cada UF tem liberdade para alterar esse prazo. 

Visando a observação acima, caso o cancelamento for enviado de modo offline o NeverStop realizará o agendamento daquela solicitação, para que seja enviada somente quando voltarmos a ter conexão.

 

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.