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": "[e-mail]",
        "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.

Para as tratativas via API do serviço Fulfillment, será visto/utilizado o campo recipient_document para referir o CNPJ do CD responsável pela entrega e armazenagem do sortimento.

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
    }
  ],
  (...)