Fast Shop - API Marketplace
  • Fast Shop Marketplace
  • Guia de Boas Práticas
  • Setup - Integração
  • Portal Kaive HUB
  • Autenticação
  • Produto
    • Envio de Produtos
    • Atualização de Preço e Estoque
    • Calculo de Frete
  • Pedidos
    • Status de Pedidos do Marketplace
    • Receber - Pedido do Marketplace
    • Receber - Consulta de Pedidos
    • Receber - Pagamento Aprovado do Marketplace
    • Receber - Cancelamento de Pedido do Marketplace
    • Enviar - Cancelamento de Pedido Para o Marketplace
    • Enviar - Nota Fiscal para o Marketplace
    • Enviar - Tracking para o Marketplace
    • Enviar - Informações da Entrega para o Marketplace
    • Plataformas Homologadas
Powered by GitBook
On this page

Was this helpful?

  1. Pedidos

Receber - Consulta de Pedidos

A integração precisa disponibilizar um endpoint para o Marketplace realizar a consulta de status de pedidos com base no número do pedido gerado pelo seller.

Na consulta de pedido a integração deve validar a chamada pelos headers de autenticação.

O status inicial do pedido sempre será:

Headers de Autenticação:

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

Método: GET

Endpoint: ​http://{prefixoDaIntegracao}/api/v2/fastshop/api/fulfillment/pvt/orders/{sellerOrderId}

{
  "orderId": "Numero do pedido no seller",
  "marketplaceOrderId": "Numero do pedido na FastShop",
  "status": "invoiced",
  "statusDescription": "Faturado",
  "value": 48825,
  "creationDate": "2019-04-18T16:08:09.0639321+00:00",
  "lastChange": "2019-04-19T08:15:15.5943936+00:00",
  "packageAttachment": {
    "packages": [
      {
        "items": [
          {
            "itemIndex": 0,
            "id": "2873",
            "quantity": 1,
            "price": 44900,
            "description": null,
            "unitMultiplier": 0,
            "priceTags": [
                {
                    "name": "discount@shipping-7fa78fb6-0a82-4bb6-9f15-4853e0cd467b#e3c63da3-00fe-4c45-a396-858a7cec7866",
                    "isPercentual": false,
                    "identifier": "7fa78fb6-0a82-4bb6-9f15-4853e0cd467b",
                    "rawValue": -39.90,
                    "value": -3990,
                    "rate": null,
                    "jurisCode": null,
                    "jurisType": null,
                    "jurisName": null
              }
            ]
          }
        ],
        "courier": "Rastreamento Electrolux",
        "invoiceNumber": "4525246546",
        "invoiceValue": 48825,
        "invoiceUrl": "",
        "issuanceDate": "2019-04-19T03:00:00.0000000+00:00",
        "trackingNumber": "4525246546#234234",
        "invoiceKey": "534584573465764375664564657465746545457465745",
        "trackingUrl": "https://xxxxx.com.br/tracking?tracking=234234",
        "embeddedInvoice": "",
        "type": "Output",
        "courierStatus": {
          "status": "unknown",
          "finished": true,
          "deliveredDate": "2019-04-23T13:58:00.0000000+00:00",
          "data": [
            {
              "lastChange": "2019-04-23T13:58:00.0000000+00:00",
              "city": null,
              "state": null,
              "description": "Entrega Realizada Normalmente"
            },
            {
              "lastChange": "2019-04-22T23:02:00.0000000+00:00",
              "city": null,
              "state": null,
              "description": "Tranferencia Entre Filiais"
            }
          ]
        },
        "cfop": null
      }
    ]
  },
  "allowCancellation": false,
  "allowEdition": false,
  "authorizedDate": "2019-04-18T16:14:43.1558579+00:00",
  "invoicedDate": "2019-04-19T08:15:15.4068844+00:00"
}

Observações:

Quais informações devem ser inseridas em determinados campos:

Value = Valor total do pedido, tipo de dado inteiro

CreationDate = Data de criação do pedido

AuthorizedDate = Data em que a integração recebeu a confirmação de pagamento

InvoiceDate = Data Nota Emitida

PreviousReceber - Pedido do MarketplaceNextReceber - Pagamento Aprovado do Marketplace

Last updated 1 year ago

Was this helpful?