Receber - Pedido do Marketplace

Fluxo para criação de pedidos.

A integração precisa disponibilizar um endpoint para receber os pedidos gerado no Marketplace.

Todas as vezes em que um pedido for gerado no Marketplace, essa requisição será realizada para criar o pedido na sua integração.

Nesta requisição, o Marketplace enviará o endpoint de call-back para que a integração informe os dados da emissão de nota fiscal e tracking.

O pedido nascerá com o seguinte status: O pedido sempre nascerá com o status: Pendente = waiting-ffmt-authorization

Nessa requisição Informaremos os headers abaixo:

Headers de Autenticação:

X-API-AppKey = AppKey X-API-AppToken = AppToken

Metódo: POST

Endpoint: https://{prefixoDaIntegracao}api/fulfillment/pvt/orders?sc={NumeroPoliticaComercial }&affiliateId=FSH

Response: 200

Request Body

[
  {
    "marketplaceOrderId": "999999999",
    "marketplaceServicesEndpoint": "https://FSH-hub.kaive.com.br/",
    "marketplacePaymentValue": 2301,
    "items": [
      {
      
      "priceTags": [
                {
                    "isPercentual": false,
                    "identifier": "1234abc-5678b-1234c",
                    "name": "Desconto Pix",
                    "rawValue": 0, 
                    "value": -200     
                }
                    ],
                     
       "id": "96",
        "quantity": 1,
        "seller": "1",
        "commission": 0,
        "freightCommission": 0,
        "price": 890
      }
    ],
    "clientProfileData": {
      "id": "clientProfileData",
      "email": "[e-mail]",
      "firstName": "MeuNome",
      "lastName": "MeuSobrenome",
      "document": "00000000000", // CPF
      "phone": "(11) 99999-9999",
      "corporateName": "",
      "tradeName": "",
      "corporateDocument": "",
      "stateInscription": "",
      "corporatePhone": "",
      "isCorporate": false,
      "userProfileId": "f2a7ed91-c6c4-4d26-85fa-acb123793d82"
    },
    "shippingData": {
      "id": "shippingData",
      "address": {
        "addressType": 2,
        "receiverName": "Nome-de-quem-recebera-pedido",
        "addressId": "Casa",
        "postalCode": "02029001",
        "city": "SAO PAULO",
        "state": "SP",
        "country": "BRA",
        "street": "AV Zaki Narchi",
        "number": "1650",
        "neighborhood": "Carandiru",
        "complement": "Loja da FastShop",
        "reference": null
      },
      "logisticsInfo": [
        {
          "itemIndex": 0,
          "selectedSla": "Convencional",
          "lockTTL": "8bd",
          "shippingEstimate": "6bd",
          "price": 1411,
          "deliveryWindow": null
        }
      ]
    },
    "customData": {},
    "openTextField": {
      "value": "{\"parcels\":1,\"totalValueWithInteret\":2301,\"parcelValue\":2301,\"orderFastshop\":\"999999999\"}"
    }
  }
]

O Campo: document informará sempre o valor de um CPF, indicando que a compra é de uma Pessoa Física (PF).

O Campo: corporateDocument informará sempre o valor de um CNPJ, indicando que a compra é de uma Pessoa Jurídica (PJ)

Atualmente os pedidos de Marketplace são realizados apenas em cartão de crédito, não temos a opção de venda no boleto, voucher, ou cupom de desconto.

O Marketplace envia apenas um pedido por vez, apesar de o Json começar com um array, atualmente nós enviamos apenas um pedido por request.

Response Body

[   
    {     
        "marketplaceOrderId":"Numero_Pedido_Marketplace",     
        "orderId":"Numero_Pedido_Gerado_Seller"   
    } 
]

O campo orderId é o campo em que a integração do seller deve retornar o Numero_Pedido_Gerado_Seller.

Caso sua integração tenha alguma indisponibilidade momentânea no momento em que o Marketplace for enviar o pedido para a sua integração deve ser retornado o status:

HTTP: 500 - Internal Server Error

Com o seguinte body response:

{
   "error": {
   "code": "1",
   "message": "O verbo 'GET' não é compatível com a rota '/api/fulfillment/pvt/orders'",
   "exception": null
   }
}

Com isso a cada 20 minutos por 3 vezes a nossa integração tentará reenviar o pedido.