Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Painel
borderColor#00BFFF

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.


Painel
borderColorLightGray
titleÍndice [!https://bsoft.com.br/img/logoBsoft/logoBlogo.png|align=right,width=70px, height=20px29px!|https://www.bsoft.com.br/]

Índice
stylecircle





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


Bloco de código
languagejs
themeMidnight
titleExemplo: request endpoint POST /edi/magazine_luiza
linenumberstrue
{
	"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âmetroDescrição
developerMessageMensagem 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.

errorCodeCódigo de erro específico para o cenário de negócio.
moreInfoDocumentação com detalhes sobre o erro.


Bloco de código
languagejs
themeMidnight
titleExemplo: corpo do response
linenumberstrue
{
	"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"
}





Painel
borderColorLightGray


Html
<p style="text-align: center"><font color="black">Não encontrou o que precisava? Clique </font><a target="_blank" href="https://www.bsoft.com.br/atendimento#contatoBsoft">aqui</a><font color="black"> para solicitar atendimento ao nosso Suporte Técnico.</font></p>
<p style="text-align: center"><font color="#1457a2"><b>Horário de Atendimento (Horário de Brasília):</b></font></p>

Segunda a Sexta: das 8:00 às 18:00 (exceto feriados| Sábado: das 8:00 às 12:00.