1. Inicio
  2. Documentos
  3. NS BPe (English)
  4. BPe Issue Process
  5. Check Issue Process Status ( Step 2/3 )

Check Issue Process Status ( Step 2/3 )

This service is used to check the processing status of a BP-e previously sent for processing using the BP-e Issuance method


Production: POST https://bpe.ns.eti.br/v1/bpe/issue/status

Input Data
FieldOccurrenceData TypeDescription
X-AUTH-TOKEN1-1StringSoftware House access token
CNPJ1-1IntCNPJ of the BP-e issuer
nsNRec1-1IntReceipt log number for the issue process

Request Example

Check Processing Status Request

curl -X POST \
-H "Content-Type: application/json" \
-d '{
      "CNPJ": "11111111111111", 
      "nsNRec": 1
     }' \
Returned Data
FieldDescriptionOccurrenceData TypeParentNotes
StatusProcessing status code1-1String
MotivoLiteral description of processing status1-1String
chBPeBP-e access key1-1Int
cStatBP-e processing status code at Sefaz0-1IntOnly in status = 200
xMotivoLiteral description of processing status at Sefaz0-1StringOnly in status = 200
nProtBP-e authorization protocol number at Sefaz0-1IntOnly in status = 200
dhRecbtoDate and time of receipt of BP-e by Sefaz0-1String ( Date and Time )Only in status = 200
xmlBP-e distribution XML0-1StringOnly in status = 200
Object containing error information in case the request cannot be carried out successfully
0-1ObjectOnly in status different than 200
cStatError status code1-1Interro
xMotivoLiteral description of the error1-1Stringerro
Response Examples

Successful Return

    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "chBPe": "43180107364617000135630000000000101000000085",
    "cStat": "100",
    "xMotivo": "Autorizado o uso do BP-e",
    "nProt": "143180000001887",
    "dhRecbto": "2018-01-31T19:46:20-02:00",
    "xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><bpeProc versao=\"1.00\" xmlns=\"http://www.portalfiscal.inf.br/bpe\"><BPe>...</bpeProc>"

Response with an error

    "status": -2,
    "motivo": "Nao foi possivel carregar o status do BP-e",
    "erro": {
        "cStat": 997,
        "xMotivo": "Documento não Localizado em Nosso Banco de Dados"
Returned Codes
200Consultation made successfully
It was not possible to load the processing status of the BP-e. Check the "erro" object for more information

Como podemos ajudar?