Logística
Países
Listar países
GET https://api.dooki.com.br/v2/{alias}/logistics/countries
Response
Armazéns
Listar armazéns
GET https://api.dooki.com.br/v2/{alias}/logistics/warehouses
Request
Response
Criar armazéns
POST https://api.dooki.com.br/v2/{alias}/logistics/warehouses
Visualizar armazém
GET https://api.dooki.com.br/v2/{alias}/logistics/warehouses/{id}
Atualizar armazém
PUT https://api.dooki.com.br/v2/{alias}/logistics/warehouses/{id}
Excluir armazém
DELETE https://api.dooki.com.br/v2/{alias}/logistics/warehouses/{id}
Estoques
O lojista pode ter um cadastro de múltiplos estoques onde ele pode associar posteriormente os SKUS com suas respectivas quantidades. Um exemplo prático é permitir que ele consiga trabalhar com estoques de fornecedores externos com diferentes prazos de entrega.
Caso um SKU estiver relacionado a um estoque, a disponibilidade final de entrega será sempre a maior.
Listar estoques
GET https://api.dooki.com.br/v2/{alias}/logistics/stocks
Request
Response
Criar estoque
POST https://api.dooki.com.br/v2/{alias}/logistics/stocks
Visualizar estoque
GET https://api.dooki.com.br/v2/{alias}/logistics/stocks/{id}
Atualizar estoque
PUT https://api.dooki.com.br/v2/{alias}/logistics/stocks/{id}
Excluir estoque
DELETE https://api.dooki.com.br/v2/{alias}/logistics/stocks/{id}
Reservas de estoque
Acesso as informações de reserva de estoque criada para pedidos. Includes disponíveis: orders.
Listar reservas de estoque
GET https://api.dooki.com.br/v2/{alias}/logistics/stock-reservation
Também é possível acessar as informações de uma reserva de estoque em específico
GET https://api.dooki.com.br/v2/{alias}/logistics/stock-reservation/{id}
Response ao listar reservas de estoque
É possível utilizar filtros nesse endpoint por parâmetro, são eles: sku_id
, stock_id
, order_id
e busca por nome de produto ou sku, pelo parâmetro q
.
Exemplos:
GET https://api.dooki.com.br/v2/{alias}/logistics/stock-reservation?order_id=32
GET https://api.dooki.com.br/v2/{alias}/logistics/stock-reservation?q=Jogo
Embalagens
Listar embalagens
GET https://api.dooki.com.br/v2/{alias}/logistics/boxes
Request
Response
Criar embalagem
POST https://api.dooki.com.br/v2/{alias}/logistics/boxes
Visualizar embalagem
GET https://api.dooki.com.br/v2/{alias}/logistics/boxes/{id}
Atualizar embalagem
PUT https://api.dooki.com.br/v2/{alias}/logistics/boxes/{id}
Excluir embalagem
DELETE https://api.dooki.com.br/v2/{alias}/logistics/boxes/{id}
Transportadoras
Listar transportadoras
GET https://api.dooki.com.br/v2/{alias}/logistics/carriers
Request
Response
Criar transportadora
POST https://api.dooki.com.br/v2/{alias}/logistics/carriers
Visualizar transportadora
GET https://api.dooki.com.br/v2/{alias}/logistics/carriers/{id}
Atualizar transportadora
PUT https://api.dooki.com.br/v2/{alias}/logistics/carriers/{id}
Excluir transportadora
DELETE https://api.dooki.com.br/v2/{alias}/logistics/carriers/{id}
Preços de frete (planilhas)
Request
Response
Filtros personalizados
Esse tipo de filtro não utiliza a sintaxe global. Neste caso, o parâmetro é passado individualmente via query string na URL.
Listar preços de uma transportadora
GET https://api.dooki.com.br/v2/{alias}/logistics/carriers/{carrierId}/prices
Criar preço para uma transportadora
POST https://api.dooki.com.br/v2/{alias}/logistics/carriers/{carrierId}/prices
Visualizar preço
GET https://api.dooki.com.br/v2/{alias}/logistics/carriers/{carrierId}/prices/{id}
Atualizar preço
PUT https://api.dooki.com.br/v2/{alias}/logistics/carriers/{carrierId}/prices/{id}
Excluir preço
DELETE https://api.dooki.com.br/v2/{alias}/logistics/carriers/{carrierId}/prices/{id}
Exportar preços
GET https://api.dooki.com.br/v2/{alias}/logistics/carriers/{carrierId}/prices/export
Dica: os filtros de busca também estão disponíveis no endpoint de exportação.
O sistema enviará para o usuário um e-mail com o link para download da planilha com os registros.
Consulta de CEP
Response de consulta de CEP
Consultar CEP
GET https://api.dooki.com.br/v2/{alias}/logistics/zipcode/{zipcode}
Calcular frete
Request
Response de cálculo de frete
Calcular frete
POST https://api.dooki.com.br/v2/{alias}/logistics/shipping-costs
API de frete
Com este recurso é possível conectar APIS externas de cálculo de frete de serviços que não são integrados nativamente na Yampi.
Para habilitar este recurso, o lojista precisa criar uma API de frete pelo painel da Yampi, acessando o menu Configurações > Logística > API de Frete
Você deverá cadastrar:
Nome da API
URL da API
Headers (optional)
Já com sua API cadastrada, quando um comprador solicitar um cálculo de frete, a Yampi enviará um request via POST para a URL informada. O formato do payload será:
Após receber o request da Yampi, sua aplicação deverá, obrigatoriamente, retornar a cotação de frete no seguinte formato:
Importante:
sua aplicação deve responder a request em até 5 segundos, no máximo. Caso contrário, a Yampi irá abortar a request;
A API de frete será automaticamente desativada se detectarmos 20 falhas de requisições.
Segurança nas requisições
A validação da requisição serve para verificar se realmente ela foi enviado pela Yampi, e é de extrema importância a sua utilização para que suas transações estejam seguras.
Para cada API de frete é gerada uma chave secreta, onde utilizamos dela para gerar uma assinatura em cima do body da solicitação.
Valor do header X-Yampi-Hmac-SHA256. Vamos chamar esse valor de "assinatura da requisição";
Corpo da requisição. Com esses dois valores, basta realizar o base64 do algoritmo HMAC-SHA256 do corpo da requisição utilizando a chave secreta da API de frete e comparar com a assinatura da requisição. Se os valores forem iguais, excelente. Caso contrário, não fomos nós que enviamos essa requisição!
Last updated