Callback: Início do Monitoramento (`monitoraNfe`)

🔁 Endpoint implementado pelo CLIENTE. O Qprof chama este método no seu sistema para solicitar o início (Start) do monitoramento de um conjunto de NF-e.

Padrão de comunicação

Autenticação em 2 etapas (mesmo padrão da Qprof API). Seu sistema deve expor obrigatoriamente os métodos authentication (autenticação) e monitoraNfe (início do monitoramento).

O corpo trafega como arquivo gzip (JSON comprimido), pela possibilidade de grande volume de dados.

Requisição recebida (Q'Prof → Cliente)

{
  "dados": [
    {
      "cpf_cnpj_emitente": "00000000000000",
      "cpf_cnpj_destinatario": "0000000000 ou 00000000000000",
      "nome_transportadora": "Transportadora Teste",
      "cpf_cnpj_transportadora": "0000000000 ou 00000000000000",
      "chave_nfe": "123456789012345679012345678901234567901234",
      "valor_operacao": 7123.11,
      "numero_nota_fiscal": 123333,
      "numero_aditivo": 12534
    }
  ]
}

Estrutura

Propriedade	Tipo	Descrição
`dados`	Array	Lista de objetos Dados (NF-e a monitorar).

Objeto `dados`

Propriedade	Tipo	Descrição
`cpf_cnpj_emitente`	String	CNPJ da empresa emitente da NF-e.
`cpf_cnpj_destinatario`	String	CPF/CNPJ do destinatário da NF-e.
`nome_transportadora`	String	Nome da transportadora.
`cpf_cnpj_transportadora`	String	CPF/CNPJ da transportadora.
`chave_nfe`	String	Chave eletrônica da NF-e.
`valor_operacao`	Number	Valor da operação da NF-e.
`numero_nota_fiscal`	Number	Número da NF-e existente no Q'Prof.
`numero_aditivo`	Number	Número do aditivo existente no Q'Prof.

Resposta esperada (Cliente → Qprof)

Retorne apenas o HTTP Status Code 200 (sucesso) ou 400 (falha), com um JSON no corpo:

{
  "sucesso": true,
  "mensagem": "Retorno recebido com sucesso."
}

Próximo passo

Após iniciar o monitoramento, envie as atualizações de status ao Qprof via POST /servicos/controladoria/receberStatusNfe.

Callback: Início do Monitoramento (`monitoraNfe`)

Padrão de comunicação#

Requisição recebida (Q'Prof → Cliente)#

Estrutura#

Objeto dados#