Como funciona?
No Yuju, você poderá gerenciar suas vendas para tornar seu processo com o marketplace o mais completo possível.
Entre as funcionalidades que você terá à disposição estão:
Pesquisa de pedidos por marketplace e data de criação.
Obter os detalhes do pedido.
Alteração do status.
Download de guias.
Observação: algumas funcionalidades podem não estar disponíveis em alguns marketplaces.
Termos gerais.
shop_pk – O ID da loja à qual o pedido pertence.
markplace_pk – O ID do marketplace ao qual o pedido pertence.
order_pk – O ID do pedido.
items_pk – O ID do item do pedido que está sendo atualizado.
Pesquisa de pedidos.
GET /shops/{shop_pk}/marketplace/{marketplace_pk}/orders/
Filtro de data de criação.
created_at__gt - maior que.
created_at__gte - maior ou igual a.
created_at__lt - menor que.
created_at__lte - menor ou igual a.
Filtro por status.
As vendas são consideradas em aberto sempre que não estiverem entregues ou canceladas.
Open - Aberto.
Fechado - Fechado.
Paginado.
page - número da página.
page_size - Número de itens a serem retornados (padrão 30, máximo 100).
Documentação:
Saiba mais aqui.
Confirmação de pedidos.
POST.
/shops/(shop_pk)/marketplace/(marketplace_pk)/orders/(order_pk)/ready_to_ship/
Se o pedido tiver a ação “set ready to ship”, significa que a venda pode ser confirmada.
É permitido fazer confirmações por item; para isso, deve-se enviar no corpo da solicitação um objeto com os ITEM_PK que se deseja confirmar.
Marketplaces que exigem confirmação por item:
Linio - Isso determina o agrupamento em guias.
Liverpool - Desativado até que haja a separação das guias.
Coppel.
Saiba mais aqui.
Download de remessas.
POST /shops/(shop_pk)/marketplace/(marketplace_pk)/orders/(order_pk)/label/
Se o pedido tiver a ação print delivery label, significa que é possível baixar a guia de remessa.
É permitido baixar guias por item; para isso, deve-se enviar no corpo da solicitação um objeto com o ITEM_PK.
O formato do arquivo solicitado deve ser enviado nos cabeçalhos.
Accept – O formato da etiqueta depende do cabeçalho Accept; as opções de etiqueta são application/pdf e application/zpl.
Marketplaces que permitem o download por item:
Linio (depende do agrupamento feito durante a confirmação), aceita apenas PDF.
Walmart (sempre gera 1 guia por item).
Liverpool – Em desenvolvimento.
Coppel – Aguardando liberação por parte da Coppel.
Saiba mais aqui.
Integrações externas.
Como registrar processos externos e botões de repetição?
Com o objetivo de relacionar fluxos e processos de sistemas externos, o Yuju oferece a possibilidade de armazenar informações personalizadas dessas integrações.
Além disso, é possível adicionar ações que tenham impacto no processamento de uma venda no sistema do cliente.
Descrição dos pagamentos.
module_name: Nome do módulo externo que realizou o registro (int_external).
created_at: Data de criação do registro.
updated_at: Data de atualização do registro.
status: O status da integração.
type: Tipo de documento/registro.
reference: ID e/ou código (pode ser alfanumérico) que faz referência ao sistema criado.
id_shop, id_channel, id_order: São os valores do pedido no Yuju.
extra: Informações não padronizadas adicionadas a título informativo.
Ações: São as ações que podem ser executadas para esse registro.
Definição de botões na interface.
Dentro do objeto int_external encontram-se as listas de ações; os campos importantes são:
name: Nome da ação a ser executada (action).
message: Texto que aparece no botão (descreve a ação a ser executada).
params: Parâmetros que devem ser enviados na solicitação (payload).
Resposta:
Códigos:
200: sucesso!
400: algum erro no envio de informações
{
“message”: “texto do erro ou o que foi retornado pelo serviço externo”
}
Saiba mais aqui.
Para qualquer dúvida e/ou esclarecimento, entre em contato com seu KAM designado ou escreva para soporte@yuju.io.