SkyHub API
SkyHub PortalApi Explorer
  • Sobre a API SkyHub
  • Comunicados
    • Comunicados 2025
      • Criação e atualização de produtos e variações no Marketplace
      • Atualizações dos pedidos no Marketplace
      • Etiquetas Americanas Entrega
    • Comunicados 2024
      • Novo canal de atendimento
      • Remoção do array "categories" na busca de produtos
      • Novos campos no JSON de Pedidos
    • Comunicados 2023
      • Personalização de Preço Por Marca
      • Obrigatoriedade de body em métodos POST/PUT/PATCH
    • Comunicados 2022
      • Inativação do endpoint /categories
      • MultiCD: Substituição do store_status pelo statuses
      • Bloqueio de requisições com x-account inválido - Prazo não definido
      • Mudança na atualização da chave da nota fiscal
    • Comunicados 2021
      • Código de homologação da Anatel
      • Atributo Garantia
      • Envio de Imagens para o Mktp B2W
      • Mudança response HTTP /delivery
      • Mudança Faturamento Pedidos B2W Entrega Direct
      • Limite de Categorias na SkyHub
      • Limite de Imagens na SkyHub
      • Mudança response HTTP /invoice e /shipments
      • Mudança Infraestrutura SkyHub
      • Protocolo HTTP/HTTPS
      • Consumo de Pedidos | Preço
      • X-Accountmanager-Key
    • Comunicados 2020
      • Requisição Duplicada
      • Requisição Contas Inativas
      • Entrega Agendada by Direct
      • Headers para Requisições
      • Consumo de Pedidos
      • Atributo Data Faturamento
      • Atributo Data Enviado
  • Guias API SkyHub
    • Autenticação e formato dos dados
    • Códigos de retorno (HTTP status)
    • Limite de requisições
    • Melhores práticas
  • Recursos
    • Produtos
    • Rehub
    • Pedidos
    • Erros
    • Etiquetas
    • Fulfillment
    • Multi Origem
    • Perguntas e Respostas
    • SAC
    • Credenciamento
  • Processo de Homologação
    • Perfil para Homologação
    • Pré-Requisitos
    • Validações
      • Produtos
      • Conexão via API (Rehub)
      • Pedidos
      • Etiqueta (PLP)
    • Melhores Práticas
      • Produtos
      • Pedidos
      • Etiqueta PLP
  • Perguntas Frequentes
  • Produtos
    • > Integração Produto
    • Categorização
      • Consultar lista de Categorias
      • Consultar atributos por categoria
    • Consultar Marcas
    • Criação de Produto
      • Produto Simples
      • Produto Variável
    • Atualização de Produto
      • Produto Simples
      • Produto Variável
    • Consulta de Produto
      • Produto Simples e Variável
      • Variação de Produto
    • Exclusão de Produto
      • Produto Simples e Variável
      • Variação de Produto
    • Outros Recursos de Produtos
      • Filtros de Consultas
      • Endpoint Atributos
      • Consulta URL
        • URL Variações
  • Rehub
    • > Integração Rehub
    • Rehub - Ações de Produto
    • Resultado das Ações de Produto
  • Pedidos
    • > Integração Pedido
    • Criação e Aprovação de Pedido Teste
    • Atualização de Pedidos
    • Faturamento Pedido - Americanas Entrega Direct
    • Consumo de Pedidos - Queues
    • Notificação de Pedidos
    • Consulta de Pedidos
  • Erros
    • Consulta de Erros de Sincronização e Produção
  • Etiquetas Americanas Entrega
    • > Integração Etiqueta
    • Etiqueta de Frete - Direct
      • Padrão da Etiqueta Direct
      • Direct - Processos via API
      • Etiqueta Clique e Retire - Direct
    • Etiqueta de Frete - Correios
      • Padrão da Etiqueta Correios
      • Correios - Processos via API
      • Etiqueta Clique e Retire - Correios
  • Frete
    • > Integração Frete
    • Como Homologar
    • Melhores Práticas
  • Fulfillment
    • > Integração Fulfillment
    • Consulta de Estoque
    • Identificando Pedido
    • Faturamento
    • Consulta de Notas
    • Faturador
      • Regra Fiscal
      • Regras Tributárias
      • Relacionamento entre Produto e Regra
        • Produto Simples
        • Produto Variável
  • Multi Origem
    • > Integração Multi Origem
    • Solicitar Credenciais
    • Criar e Consultar CD
    • Criação e Atualização de Estoque
    • Pedido Multi Origem
    • Etiqueta Multi Origem
  • Perguntas e Respostas Americanas
    • > Integração Q&A
    • Perguntas e Respostas (Q&A)
  • SAC
    • > Integração SAC
    • Listar SAC
    • Chats
    • Consulta de Itens
    • Instâncias geradas de SAC
    • Actions
    • Refunds
Powered by GitBook
On this page
  • Identificando um pedido Americanas Fulfillment
  • Identificando o CD de faturamento
  1. Fulfillment

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": "comprador@exemplo.com.br",
        "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
    }
  ],
  (...)
PreviousConsulta de EstoqueNextFaturamento

Last updated 2 years ago