Este documento traz orientações para realizar a Integração com a API Bsoft.
Para esta Integração, deve ser utilizada a URL Base https://api.bsoft.com.br/sistema/v1/ para todos os endpoints.
Índice 
Recepção de Pedido de Transporte do Magazine Luiza (POST /edi/magazine_luiza)
Para esta integração, é obrigatório o uso do cabeçalho token para identificar a Empresa para a qual as informações serão enviadas.
Corpo da Requisição
Exemplo: request endpoint POST /edi/magazine_luiza
{
"order": {
"id": "NUMPEDPRINC|strPedido_cli",
"seller": {
"id": "magazineluiza|casaamerica"
},
"additionalInformation": {
"orderId": "9114400811414040",
"suborderUuid": "aef7116c-9574-42aa-9255-cb8635e39eka",
"suborderId": 654750498,
"modalityId": "RD1",
"modalityDescription": "RODO D1"
}
},
"packages": [
{
"id": "NUMPEDVEN|package_id_site",
"deliveryService": {
"id": 1,
"description": "Expressa"
},
"packingList": {
"id": 1080500
},
"deadline": {
"date": "2019-08-20",
"period": "T"
},
"shipping": {
"cost": 45.2
},
"volumes": [
{
"weight": 52.1, // kg
"height": 169, // cm
"width": 73, // cm
"length": 75, // cm
"label": {
"barcode": "123456789012345679"
},
"products": [
{
"id": "023001400",
"description": "KIT 3 EM 1 BRITANIA LIQUI BATEESPREME VEO 110V",
"weight": 52.1, // kg
"height": 169, // cm
"width": 73, // cm
"length": 75 // cm
}
]
},
{
"weight": 52.1, // kg
"height": 169, // cm
"width": 73, // cm
"length": 75, // cm
"label": {
"barcode": "123456789012345678"
},
"products": [
{
"id": "221707100",
"description": "RELOGIO FEM ANALO 53737LPMGRE2 MONDAINE ROSE NA",
"weight": 52.1, // kg
"height": 169, // cm
"width": 73, // cm
"length": 75, // cm
"category": {
"id": "LI",
"description": "Livros"
}
}
]
}
],
"invoice": {
"key": "35180947960653000186550010001541691001549777",
"number": 1253445622,
"serie": "51",
"issueDate": "2018-10-22",
"amount": {
"total": 1253.98,
"items": 1240.62
},
"cte": {
"key": "29190524230747001176570100000000021000000021",
"issueDate": "2018-10-22",
"issuer": {
"name": "MAGAZINE LUIZA S/A",
"cnpj": "000000000000000"
},
"origin": {
"address": {
"city": "LOUVEIRA",
"ibgeCode": 3205002,
"state": "SP",
"number": "0",
"street": "ROD DOS BANDEIRANTES - KM 68 E 760 METRO",
"zipcode": "13290000",
"district": "BAIRRO DO RIO ABAIXO",
"complement": "SETOR A"
}
},
"destination": {
"address": {
"city": "LOUVEIRA",
"ibgeCode": 3205002,
"state": "SP",
"number": "0",
"street": "ROD DOS BANDEIRANTES - KM 68 E 760 METRO",
"zipcode": "13290000",
"district": "BAIRRO DO RIO ABAIXO",
"complement": "SETOR A"
}
}
},
"issuer": {
"cnpj": "47960950091330",
"ie": "0402992109650",
"name": "MAGAZINE LUIZA S/A",
"tradingName": "CD505",
"address": {
"zipcode": "13290000",
"street": "ROD DOS BANDEIRANTES",
"number": "KM 68 E 760 METRO",
"complement": "",
"district": "BAIRRO DO RIO ABAIXO",
"city": "Louveira",
"state": "SP",
"country": "BR","ibgeCode": 3118601
}
},
"cfop": 5152,
"icms": 18.3,
"icmsSubstitution": 5.2,
"baseIcms": 17.3,
"baseIcmsSubstitution": 6.3
},
"origin": {
"seller": {
"id": "casaamerica"
},
"pickupPlace": {
"distributionCenter": {
"id": 300,
"name": "Centro de Distribuicao 300",
"email": "cd300@magazineluiza.com.br",
"cnpj": "111151511",
"ie": "2121211"
},
"store": {
"id": 595,
"email": "loja595@magazineluiza.com.br",
"cnpj": "111151511",
"ie": "2121211"
},
"customer": {
"name": "Diego Pereira Lourenço",
"rg": "44.611.830-X",
"cpf": "11122233344",
"Cnpj": "111151511",
"ie": "2121211"
}
},
"phones": [
{
"type": "phone",
"number": 1637201245
},
{
"type": "cellphone",
"number": 16992353961
}
],
"address": {
"zipcode": "13290000",
"street": "ROD DOS BANDEIRANTES",
"number": "KM 68 E 760 METRO",
"complement": "",
"district": "BAIRRO DO RIO ABAIXO",
"city": "Louveira",
"state": "SP","country": "BR",
"ibgeCode": 3118601
}
},
"destination": {
"seller": {
"id": "magazineluiza"
},
"deliveryPlace": {
"distributionCenter": {
"id": 300,
"name": "Centro de Distribuicao 300",
"email": "cd300@magazineluiza.com.br",
"cnpj": "111151511",
"ie": "2121211"
},
"store": {
"id": 595,
"email": "loja595@magazineluiza.com.br",
"cnpj": "111151511",
"ie": "2121211"
},
"customer": {
"name": "Diego Pereira Lourenço",
"rg": "44.611.830-X",
"cpf": "11122233344",
"cnpj": "111151511",
"ie": "2121211"
}
},
"phones": [
{
"type": "phone",
"number": 1637201245
},
{
"type": "cellphone",
"number": 16992353961
}
],
"address": {
"zipcode": "13290000",
"reference": "ROD",
"street": "ROD DOS BANDEIRANTES",
"number": "KM 68 E 760 METRO",
"complement": "",
"district": "BAIRRO DO RIO ABAIXO",
"city": "Louveira",
"state": "SP",
"country": "BR",
"ibgeCode": 3118601
}
}
}
]
}
Retorno de Sucesso - HTTP Status Code 201
Em caso de sucesso, deve ser retornado no corpo da resposta o qeu foi enviado no corpo da requisição.
Retorno em caso de Erro
| Parâmetro | Descrição |
|---|---|
| developerMessage | Mensagem de erro técnica, voltada para o time de desenvolvedores que consome a API. |
| userMessage | Mensagem de erro mais clara, voltada para o cliente final da aplicação. |
| errorCode | Código de erro específico para o cenário de negócio. |
| moreInfo | Documentação com detalhes sobre o erro. |
Exemplo: corpo do response
{
"developerMessage" : "Unauthorized - make sure the header parameter Authorization is valid",
"userMessage" : "You are not authorized to perform this operation",
"errorCode" : 30001,
"moreInfo": "http://developer.apiluiza.com.br/docs/errors/30001"
}
Segunda a Sexta: das 8:00 às 18:00 (exceto feriados) Sábado: das 8:00 às 12:00.