Identificando Pedido
Nesta seção é possível consultar como se dá a identificação de pedidos Fulfillment
Identificando um pedido Americanas Fulfillment
Existem situações em que a loja possui mais de um Centro de Distribuição (CD), além daquele disponibilizado pelo serviço Fulfillment, para executar a gestão logística de suas vendas. Caso haja estoque do item selecionado pelo cliente em ambos os CDs, a prioridade de envio será sempre pelo Fulfillment.
Ao consumir os pedidos da loja, a identificação de uma entrega Fulfillment se dá através do campo shipping_method
, onde será informado o valor B2W Fulfillment.
Tanto para pedidos Fulfillment quanto para aqueles gerados para o Americanas Entrega Direct haverá o campo calculation_type
contendo o valor b2wentregadirect
, sendo imprescindível a consulta do shipping_method
.
Se o parâmetro shipping_method
estiver preenchido com quaisquer outras informações além de B2W Fulfillment, cabe ao seller verificar qual a transportadora a ser utilizada para a entrega.
Uma vez que o campo shipping_method
for preenchido com o valor B2W Fulfillment, o pedido será enviado pelo CD da Americanas, isto é, quando houver a sua aprovação, o seller deverá realizar o faturamento, encaminhando o XML da nota fiscal via integração e os demais passos até a entrega ficarão sob responsabilidade do marketplace.
Pedidos identificados como B2W Fulfillment não devem ser enviados pelo CD do lojista.
A seguir temos as informações do consumo de um pedido Fulfillment criado em ambiente de teste:
{
"shipping_method": "B2W Fulfillment",
"calculation_type": "b2wentregadirect",
"linked_order": null,
"billing_address": {
"street": "Avenida Paulista",
"secondary_phone": "99 999999999",
"region": "SP",
"reference": null,
"postcode": "90000000",
"phone": "99 999999999",
"number": "1234",
"neighborhood": "Bela Vista",
"full_name": "João dos Santos",
"detail": "Próximo ao museu",
"country": "BR",
"complement": null,
"city": "São Paulo"
},
"shipping_address": {
"street": "Avenida Paulista",
"secondary_phone": "99 999999999",
"region": "SP",
"reference": null,
"postcode": "90000000",
"phone": "99 999999999",
"number": "1000",
"neighborhood": "Bela Vista",
"full_name": "João dos Santos",
"detail": "Ao lado da cafeteria",
"country": "BR",
"complement": null,
"city": "São Paulo"
},
"available_to_sync": true,
"imported_at": "2023-05-17T12:30:47-03:00",
"estimated_delivery": "2023-05-31T00:00:00-03:00",
"updated_at": "2023-05-17T12:30:47-03:00",
"total_ordered": 39.9,
"tags": [],
"sync_status": "NOT_SYNCED",
"code": "Lojas Americanas-1684000000137",
"delivery_contract_type": "",
"estimated_delivery_shift": null,
"shipping_carrier": "B2W Fulfillment",
"customer": {
"vat_number": "23455567899",
"phones": [
"99 999999999"
],
"name": "João dos Santos",
"gender": "male",
"email": "[email protected]",
"date_of_birth": "1989-01-01"
},
"interest": 0.0,
"target_order": null,
"sync_sale_system": null,
"import_info": {
"ss_name": "Lojas Americanas",
"remote_id": null,
"remote_code": "1684000000137",
"pack_id": null,
"cart_id": null
},
"discount": 0.0,
"shipped_date": "",
"items": [
{
"special_price": 39.9,
"shipping_cost": null,
"remote_store_id": null,
"qty": 1,
"product_id": "2023001",
"original_price": 39.9,
"name": "Camiseta Branca Tam. Único",
"listing_type_id": null,
"id": "2023001",
"gift_wrap": null,
"detail": null,
"delivery_line_id": null
}
],
"first_exported_at": null,
"id": "6464f000000000000c687c7f",
"placed_at": "2023-05-17T12:30:47-03:00",
"delivered_date": null,
"shipments": [],
"shipping_estimate_id": "",
"shipping_cost": 0.0,
"shipping_method_id": null,
"delivery_token": {
"takeout": null,
"failure": null,
"customer": null
},
"payments": [
{
"value": 39.9,
"type": null,
"transaction_date": null,
"status": null,
"sefaz": {
"type_integration": null,
"payment_indicator": null,
"name_payment": null,
"name_card_issuer": null,
"id_payment": null,
"id_card_issuer": null
},
"parcels": 1,
"method": "CREDIT_CARD",
"description": "SkyHub",
"card_issuer": null,
"autorization_id": null
}
],
"channel": "Lojas Americanas",
"approved_date": "",
"invoices": [],
"status": {
"type": "NEW",
"label": "Pagamento Pendente (new) (SkyHub)",
"code": "book_product"
},
"expedition_limit_date": null,
"exported_at": null
}
Identificando o CD de faturamento
No ato da contratação do serviço, o seller decidirá qual CD Fulfillment será utilizado dentre as opções disponibilizadas pelo marketplace e receberá os dados para aquele escolhido.
No consumo do pedido, o campo remote_store_id
identificará o código do CD por onde a entrega deverá ser faturada (o mesmo deve ser informado no XML), isto é, o campo remote_store_id
visualizado no consumo do pedido é a identificação do CD, cujo CNPJ - informado ao seller durante a contratação do serviço - será incluso no XML da nota fiscal e nas tratativas via API para consulta de estoque e faturamento.
Via ambiente de teste não é possível realizar a inclusão do campo remote_store_id
, porém em produção a identificação do CD está descrita no array items e pode ser visualizada a seguir:
(...)
"items": [
{
"special_price": 39.9,
"shipping_cost": 0,
"remote_store_id": "BFF1114",
"qty": 1,
"product_id": "2023001",
"original_price": 39.9,
"name": "Camiseta Branca Tam. Único",
"listing_type_id": null,
"id": "2023001",
"gift_wrap": null,
"detail": null,
"delivery_line_id": null
},
{
"special_price": 39.9,
"shipping_cost": 0,
"remote_store_id": "BFF1114",
"qty": 1,
"product_id": "2023001",
"original_price": 39.9,
"name": "Camiseta Branca Tam. Único",
"listing_type_id": null,
"id": "2023001",
"gift_wrap": null,
"detail": null,
"delivery_line_id": null
}
],
(...)
Last updated