O serviço de emissão em contingência de BP-e é responsável por realizar a validação dos dados do BP-e enviado de acordo com os tipos de dados definidos pelos schemas XMLs da Sefaz e realizar a geração do DABPE de contingencia, juntamente com o XML que deve ser enviado posteriormente para autorização na Secretaria da Fazenda.
O retorno deste serviço contém o pdf para visualização da nota em contingencia e o xml completo para emissão posterior na NS BP-e API.
URL
Produção: POST https://bpe.ns.eti.br/v1/bpe/cont/issue
Dados de entrada
Os dados do BP-e para o método de emissão podem ser enviados em JSON ou XML.
Envio de dados em formato JSON
Para envio dos dados em JSON o Content-Type da requisição deverá ser definido como application/json.
| Campo | Ocorrência | Tipo | Pai | Descrição |
|---|---|---|---|---|
| X-AUTH-TOKEN | 1-1 | A | Token de acesso do usuário. Pode ser enviado também via Header ou QueryString na URL. | |
| BPe | 1-1 | O | Dados do BP-e (conforme Manual de Orientações do Contribuinte da Sefaz) |
Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de BP-e no formato JSON:
Envio de dados em formato XML
Para envio dos dados em XML o Content-Type da requisição deverá ser definido como application/xml e o X-AUTH-TOKEN deverá ser enviado no cabeçalho HTTP.
No envio em formato XML o corpo da requisição deverá conter o conteúdo do XML com as informações do BP-e. Esse conteúdo deverá ser gerado a partir do layout do Manual de Orientações do Contribuinte da Sefaz.
Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de BP-e no formato XML:
Exemplo de requisição
Requisição de emissão de BP-e em JSON
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"X-AUTH-TOKEN":"...",
"BPe":{...}
}' \
https://bpe.ns.eti.br/v1/bpe/cont/issue
Requisição de emissão de BP-e em XML
curl -X POST \
-H "X-AUTH-TOKEN: SEU_TOKEN" \
-H "Content-Type: application/xml" \
-d '<?xml version="1.0" encoding="utf-8"?>
<bpeProc versao="1.00" xmlns="http://www.portalfiscal.inf.br/bpe">
<BPe>
<infBPe versao="1.00" Id="BPe43211207364617000135630060000027241744225835">
<ide>
<cUF>43</cUF>
<tpAmb>2</tpAmb>
<mod>63</mod>
...
</BPe>\
https://bpe.ns.eti.br/v1/bpe/cont/issue
Dados retornados
| Campo | Descrição | Observação |
|---|---|---|
| status | Código de status do processamento | |
| motivo | Descrição literal do status de processamento | |
| chBPe | Chave da Nota emitida em Contingencia Offline | Somente em status = 200 |
| DABPE com layout de contingencia em Base64 | Somente em status = 200 | |
| xml | XML com ajustes para tentativa de emissão posterior | Somente em status = 200 |
Retorno com sucesso
{
"status": 200,
"motivo": "BP-e enviado para Sefaz",
"chBPe": "1234",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><BPe>...</BPe>",
"pdf: "JVBERi0xLjQKJeLjz..."}
Autorização do BPe Emitido em Contingencia Offline
Você deve fazer a emissão do seu documento emitido em contingencia num período de 168horas(Uma semana) para que o BP-e seja autorizado na Sefaz, utilizando do XML retornado da API neste endpoint. Para autorizar o Bpe confira o método Emissão da NS BP-e API