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.
URL
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.
| Field | Description | Notes |
|---|---|---|
| status | Processing status code | |
| motivo | Literal description of processing status | |
| nsNRec | Internal API number code for this specific processing | Only in status = -6 |
| erro | Object containing the error data that occurred during processing | Only in status = -5 or -500 |
| erro | Error status code | |
| xMotivo | Literal description of the error |
Responses Examples
Successful Response
{
"status": 200,
"motivo": "Importação realizada com sucesso"
}
Returned Codes
| Field | Description |
|---|---|
| 200 | Importation done successful |
| -3 | Unrecognized version of XML |
| -4 | XML structure error |
| -5 | Error while importing Check the xMotivo tag |
| -6 | "BPe already sent, but not yet consulted" |
| -7 | Document already present in our database |
| -8 | XML passes 3 months after its issuance |
| -9 | Situation different from those allowed ( Not Authorized ) |
| -500 | Internal error when making the request Check the error object for more information. |