Fulfillment Marketplaces

A forma como o serviço Fulfillment funciona para outros marketplaces irá depender de como esses outros canais criaram o fluxo, sendo assim iremos informar como realizar o envio do XML para o Fulfillment de outros canais, mas o fluxo total não será citado. Os dados para requisição abaixo contemplam os marketplaces Mercado Livre e Magazine Luíza.

Como saber se o pedido é Fulfillment?

Nestes casos, haverá uma identificação no pedido no atributo "shipping_method", onde será informado dados do método de envio e a palavra "Fulfillment", para indicação do pedido ser Fulfillment.

Se o atributo "shipping_method" vier preenchido com informação diferente da citada acima, o lojista terá de verificar qual transportadora utilizará para atender o pedido em questão.

Por exemplo: Se, "shipping_method":"-me2-Normal", o pedido deverá ser atendido pelo modo de serviço Mercado Envios.

Pedidos identificados como "Fulfillment", NÃO devem ser enviados pelo CD da loja.

Como enviar o XML da Nota ?

Para enviar o XML será utilizado o método POST o Endpoint:

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

A baixo descreveremos como enviar através de nossa API.

Envio do Arquivo XML:

Neste formato será necessário enviar o arquivo XML no body da requisição:

Example Request:

curl --location --request POST 'https://api.skyhub.com.br/orders/{code}/invoice' \
--header 'X-User-Email: seu@email.com' \
--header 'x-Api-Key: YOUR API KEY HERE' \
--header 'x-accountmanager-key: token_account' \
--header 'Accept: application/json' \
--header 'Content-Type: multipart/form-data' \
--form 'file=@/caminho/arquivo.xml'

Request Headers

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/json

Content-type

String

Required

multipart/form-data

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

O envio do XML deve ser em UTF-8-BOM

Responses:

200 - Success

Caso envie o XML em UTF-8, o aquivo não será aceito, retornando erro de formatação.