Através do serviço de evento de cobrança de excesso de bagagem é possível informar a cobrança do excesso de bagagem no BP-e.
Obs.: Este evento possui regras e prazos definidos pela Secretaria da Fazenda que devem ser consideradas e respeitadas. Para maiores informações clique aqui e verifique a versão mais atualizada o Manual de Orientações do Contribuinte da Sefaz.
URL
Produção: POST https://bpe.ns.eti.br/v1/bpe/excessobag
Dados de entrada
| Campo | Descrição | Ocorrência | Tipo | Tamanho | Observação |
|---|---|---|---|---|---|
| X-AUTH-TOKEN | Token de acesso do usuário | 0-1 | A | Pode ser enviado no cabeçalho da requisição | |
| chBPe | Chave de acesso do BP-e | 1-1 | N | 44 | |
| tpAmb | Tipo do ambiente de autorização do BP-e 1 - Produção 2 - Homologação | 1-1 | N | 1 | |
| dhEvento | Data e hora da ocorrência do evento | 1-1 | D | 25 | Padrão Sefaz AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-02:00 |
| nProt | Número do protocolo de autorização do BP-e | 1-1 | N | 15 | |
| qBagagem | Quantidade de volumes de bagagem carregados | 1-1 | N | 20 | |
| vTotBag | Valor total do serviço | 1-1 | N | 13,2 | |
| IBSCBS | Grupo das informações da Tributação IBS/CBS | 0-1 | G | ||
| CST | Código da Situação Tributária do IBS/CBS | 1-1 | N | 3 | |
| cClassTrib | Código da Classificação Tributária do IBS/CBS | 1-1 | N | 6 | |
| indDoacao | Informar quando doação | 0-1 | N | 1 | |
| gIBSCBS | Grupo de informações específicas do IBS/CBS | 0-1 | G | ||
| vBC | Valor da Base de cálculo comum a IBS/CB | 1-1 | N | 13,2 | |
| gIBSUF | Grupo de informações do IBS/CBS de competência das Unidades Federadas | 1-1 | G | ||
| pIBSUF | Alíquota do IBS Estadual | 1-1 | N | 3,2/3,4 | |
| vIBSUF | Valor do IBS de competência da UF | 1-1 | N | 13,2 | |
| gDif | Grupo de campos do diferimento | G | |||
| pDif | Percentual de diferimento | 1-1 | N | 3,2/3,4 | |
| vDif | Valor do diferimento | 1-1 | N | 13,2 | |
| gDevTrib | Grupo de informações da devolução de tributos | 0-1 | G | ||
| vDevTrib | Valor do tributo devolvido | 1-1 | N | 13,2 | |
| gRed | Grupo de informações da redução de Alíquota | 0-1 | G | ||
| pRedAliq | Percentual da redução de Alíquota do cClassTrib | 1-1 | N | 3,2/3,4 | |
| pAliqEfet | Alíquota efetiva do IBS de competência das UF | 1-1 | N | 3,2/3,4 | |
| gIBSMun | Grupo de informações do IBS/CBS de competência do município | 1-1 | G | ||
| pIBSMun | Alíquota do IBS Municipal | 1-1 | N | 3,2/3,4 | |
| vIBSMun | Valor do IBS de competência do município | 1-1 | N | 13,2 | |
| vIBS | Valor do IBS (soma de vIBSUF e vIBSMun) | 1-1 | N | 13,2 | |
| gCBS | Grupo de informações da CBS | 1-1 | G | ||
| pCBS | Alíquota da CBS | 1-1 | N | ||
| vCBS | Valor da CBS | 1-1 | N | ||
| gTribRegular | Grupo de informações da Tributação Regula | 0-1 | G | ||
| CSTReg | Código da Situação Tributária | 1-1 | N | 3 | |
| cClassTribReg | Código de Classificação Tributária | 1-1 | N | 6 | |
| pAliqEfetRegIBSUF | Alíquota efetiva da UF | 1-1 | N | 3,2/3,4 | |
| vTribRegIBSUF | Informado como seria o valor do Tributo da UF caso não cumprida a condição resolutória/suspensiva | 1-1 | N | 13,2 | |
| pAliqEfetRegIBSMun | Alíquota efetiva do Município Informado a Alíquota caso não cumprida a condição resolutória/suspensiva | 1-1 | N | 3,2/3,4 | |
| vTribRegIBSMun | Informado como seria o valor do Tributo do Município caso não cumprida a condição resolutória/suspensiva | 1-1 | N | 13,2 | |
| pAliqEfetRegCBS | Alíquota efetiva da CBS Informado a Alíquota caso não cumprida a condição resolutória/suspensiva | 1-1 | N | 3,2/3,4 | |
| vTribRegCBS | Informado como seria o valor do Tributo CBS caso não cumprida a condição resolutória/suspensiva | 1-1 | N | 13,2 | |
| gTribCompraGov | Grupo de informações da composição do valor do IBS e da CBS em compras governamental | 0-1 | G | ||
| pAliqIBSUF | Alíquota IBS da UF utilizada | 1-1 | N | 3,2/3,4 | |
| vTribIBSUF | Valor do Tributo do IBS da UF Valor que seria devido a UF, sem aplicação do Art. 473. da LC 214/20025 | 1-1 | N | 13,2 | |
| pAliqIBSMun | Alíquota IBS do Município utilizada | 1-1 | N | 3,2/3,4 | |
| vTribIBSMun | Valor do Tributo do Município da UF | 1-1 | N | 13,2 | |
| pAliqCBS | Valor do Tributo do Município da UF Valor que seria devido ao Município, sem aplicação do Art. 473. da LC 214/20025 | 1-1 | N | 3,2/3,4 | |
| vTribCBS | Valor do Tributo da CBS Valor que seria devido a CBS, sem aplicação do Art. 473. da LC 214/20025 | 1-1 | N | 13,2 | |
| gEstornoCred | Grupo de informações de estorno de crédito. | 0-1 | G | ||
| vIBSEstCred | Valor do IBS a ser estornado | 1-1 | N | 13,2 | |
| vCBSEstCred | Valor do CBS a ser estornado | 1-1 | N | 13,2 |
Exemplo de requisição
Requisição de não embarque de BP-e
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"chBPe": "43221007364617000135630060000028311000000015",
"tpAmb": "2",
"dhEvento": "2026-09-17T11:20:00-03:00",
"nProt": "143220000305850",
"qBagagem": "10000000000000000000",
"vTotBag": "1000.00",
"IBSCBS": {
"CST": "000",
"cClassTrib": "000001",
"indDoacao": "1",
"gIBSCBS": {
"vBC": "25.00",
"gIBSUF": {
"pIBSUF": "1.00",
"vIBSUF": "0.25"
},
"gIBSMun": {
"pIBSMun": "0.50",
"vIBSMun": "0.13"
},
"vIBS": "0.38",
"gCBS": {
"pCBS": "0.90",
"vCBS": "0.23"
},
"gTribRegular": {
"CSTReg": "000",
"cClassTribReg": "000001",
"pAliqEfetRegIBSUF": "1.00",
"vTribRegIBSUF": "0.25",
"pAliqEfetRegIBSMun": "0.50",
"vTribRegIBSMun": "0.13",
"pAliqEfetRegCBS": "0.90",
"vTribRegCBS": "0.23"
}
},
"gEstornoCred": {
"vIBSEstCred": "0.00",
"vCBSEstCred": "0.00"
}
},
"vTotDFe": "0.00"
}'\
https://bpe.ns.eti.br/v1/bpe/naoemb
Dados retornados
| Campo | Descrição | Tipo | Pai | Observação |
|---|---|---|---|---|
| status | Código de status do processamento | N | ||
| motivo | Descrição literal do status de processamento | A | ||
| retEvento | Objeto contendo os dados de processamento do cancelamento na Sefaz | O | Somente em status = 200 | |
| cStat | Código de situação do processamento | C | retEvento | |
| xMotivo | Descrição literal da situação do processamento na Sefaz | A | retEvento | |
| chBPe | Chave de acesso do BP-e | N | retEvento | Somente em cStat = 135 |
| dhRegEvento | Data e hora de registro do evento na Sefaz | D | retEvento | Padrão Sefaz AAAA-MM-DDTHH:MM:SS + UTCEx.: 2016-06-13T15:04:10-03:00 Somente em cStat = 135 |
| nProt | Número do protocolo de autorização do evento | N | retEvento | Somente em cStat = 135 |
| xml | XML de distribuição do evento | S | retEvento | Somente em cStat = 135 |
| erro | Objeto contendo as informações de erro caso o cancelamento não possa ser realizado com sucesso | O | Somente em status diferente de 200 | |
| cStat | Código de status do erro | N | erro | |
| xMotivo | Descrição literal do erro | A | erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Processamento de evento realizado com sucesso",
"retEvento": {
"cStat": 135,
"xMotivo": "Evento registrado e vinculado a BP-e",
"chBPe": "43180207364617000135630000000000301000000081",
"dhRegEvento": "2018-02-21T14:58:46-03:00",
"nProt": "143180000002623",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><procEventoBPe versao=\"1.00\" xmlns=\"http://www.portalfiscal.inf.br/bpe\">...</procEventoBPe>"
}
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Evento vinculado com sucesso |
| -2 | Chave de acesso inválida |
| -3 | Não foi possível vincular o evento. Verifique o objeto erro para maiores informações |
Download do Evento Excesso de Bagagem
Você pode fazer o download das informações completas de distribuição do evento em XML ou JSON. Para isso confira o método Download de Eventos na NS BP-e API.