1. Inicio
  2. Documentos
  3. NS BPe (English)
  4. Utility Functions
  5. Import


Through the BP-e Import service, it is possible to import an XML processed by SEFAZ to our bank, so that it can be used within NS services.

This functionality is widely used in cases where it is necessary to link events in a BPe that was not issued by NS.


Production: POST https://bpe.ns.eti.br/v1/bpe/import

Input Data

The file to be sent would be a BPe XML for distribution, that is, an XML already processed by SEFAZ and authorized by SEFAZ.

statusProcessing status code
motivoLiteral description of processing status
nsNRecInternal API number code for this specific processingOnly in status = -6
erroObject containing the error data that occurred during processingOnly in status = -5 or -500
erroError status code
xMotivoLiteral description of the error
Responses Examples

Successful Response

    "status": 200,
    "motivo": "Importação realizada com sucesso"
Returned Codes
200Importation done successful
-3Unrecognized version of XML
-4XML structure error
-5Error while importing
Check the xMotivo tag
-6"BPe already sent, but not yet consulted"
-7Document already present in our database
-8XML passes 3 months after its issuance
-9Situation different from those allowed ( Not Authorized )
-500Internal error when making the request Check the error object for more information.

Como podemos ajudar?