Status de Pedidos

O que são os status dos pedidos?

Os status dos pedidos representam os pontos pelos quais os pedidos passam, desde o momento da compra até a entrega ao cliente.

Quais os status dos pedidos cadastrados na Skyhub?

NEW - Pagamento Pendente (SkyHub)
NEW é o status que o pedido recebe quando gerado no marketplace.

APPROVED - Aprovado (SkyHub)
Approved é o status que o pedido recebe quando o pagamento é aprovado (confirmado).

CANCEL - Cancelado (SkyHub)
Cancel é o status que o pedido recebe quando cancelado porque o cliente desistiu da compra ou quando o lojista não tem mais o estoque para atender ao pedido.

SHIPPED - Pedido Enviado (SkyHub)
Shipped é o Status que o pedido recebe quando o lojista envia os dados de NFe e Código de Rastreio.

DELIVERY- Completo (entregue) (SkyHub)
Delivery é o status que o pedido recebe quando o pedido foi entregue ao cliente.

SHIPMENT_EXCEPTION - Exceção de Entrega (SkyHub)
Shipment_exception é o status que o pedido recebe quando por algum motivo a entrega não foi realizada.

Obs: Caso o cliente efetue o pagamento e o lojista não tiver mais o estoque o lojista pode decidir se vai ou não atender aquele pedido, caso deseje atender o mesmo deve incluir estoque para o item do pedido.

É possível consultar os status via API?
Sim, para consultar os status é necessário fazer um GET /statuses. Para deixar mais claro segue exemplo de como fazer a request





O que constitui o status do pedido?
O status do pedido possui 3 campos na API:

Code: É o código do status utilizado para a atualização do pedido.
Label: Nomenclatura do status Skyhub
Type: Status do seller que se adequa com o status Skyhub

Dentro da Skyhub, menu: Skyhub > Status dos Pedidos

• O Campo Code é a coluna #
• O Campo Label é a coluna Status
• O Campo Type é a coluna Tipo



Atualização de pedido:
No momento em que o pedido é realizado as primeiras atualizações de status de pedido são provindas do marketplace, esses status são:

• Pagamento Pendente
• Pagamento Aprovado
• Cancelado

Obs: O cancelado virá do marketplace caso o cliente desista da compra ou em casos similares.

Status que são de responsabilidade da loja enviar para o marketplace

• Entregue à transportadora.
• Entregue ao cliente
• Cancelado

Obs: O lojista poderá cancelar o pedido quando não conseguir fazer o atendimento do mesmo.

Os status podem ser verificados no portal da Skyhub seguindo o caminho no menu lateral:

Skyhub > Status dos Pedidos:

A Skyhub realiza um depara entre a coluna status com a coluna tipo.

Exemplo:

Status: Pagamento Pendente (Skyhub) é do Tipo: Pagamento Pendente

Essa função existe porque é possível criar status de pedidos dentro da Skyhub, caso você crie os seus status de pedidos é importante você dizer para a Skyhub qual o significado de cada status que você criou.

Obs: A Skyhub já cria os status necessários para a sua integração de pedidos, porém, caso haja necessidade você pode criar.

Como alterar o status dos pedidos?

Para atualizar o pedido será sempre necessário utilizar a Endpoint:

POST https://api.skyhub.com.br/orders/{code}/invoice

Após o marketplace confirmar que o pedido teve o pagamento confirmado o lojista precisa emitir a nota fiscal eletrônica (NFE) para aquele pedido, abaixo exemplo de como nos enviar essa informação:

Obs: O campo key precisa conter os 44 dígitos da NFE.



Como atualizar um pedido para enviado (Entregue a Transportadora)?

Para atualizar o pedido será sempre necessário utilizar a Endpoint:

POST https://api.skyhub.com.br/orders/{code}/shipments

Como alterar pedido para entregue?

Endpoint: POST https://api.skyhub.com.br/orders/{code}/delivery



Como cancelar um pedido:

Endpoint: POST https://api.skyhub.com.br/orders/{code}/cancel


Como atualizar o pedido para exceção de entrega:

Endpoint: POST https://api.skyhub.com.br/orders/{order-id}/shipment_exception