GET Orders by Seller

Returns orders from a specific store in determinated interval.

Fetch orders placed on connected channels, including customer, product, payment, and delivery information. Notify the channel that the order has been received and is being processed.

The ERP must query orders by store (defined in the path parameter) at intervals defined by query parameters.

Explanation of path and query parameters:

path

Value registered in Seller.Cnpj

query:

ParameterTypeRequiredDescription
datedateYesFixed. Initial cutoff date. Always send with the value 2020-01-01T00:01:01. (ISO 8601)
lastUpdateSincedateYesReturns data updated as of a given date. Ex: 2025-07-13T23:59:00. (ISO 8601)
lastUpdateUntildateYesReturns data updated up to a given date. Ex: 2025-07-14T18:32:59. (ISO 8601)
statusintYesInitial status of paid orders: 2

📘

Paid vs. Unpaid Orders

By default, status 2 (PendingCreate) represents paid orders.

You can configure the system to display newly created unpaid orders. Contact our team.

Explanation of a List of Orders return

This GET will return a list of Orders of an Seller.

root

FieldTypeDescription
idGuidUnique order identifier.
createDatedatetimeOrder creation date (ISO 8601 format).
lastUpdatedatetimeOrder last update (ISO 8601 format).
externalIdstringExternal order ID (marketplace/ERP).
sellerOrderIdstringOrder ID in the seller's system.
channelstringOrder origin channel (e.g., ecommerce).
statusintCurrent order status (e.g., 9 = Completed).
orderNotestringNote added to the order.
plpstringPLP number or logistics identification.
isDeliverybooleanIndicates whether the order is for delivery.
dealerCodestringA root field that shows the code of a Dealer who sell this order.

voucher

CampoTipoDescrição
codestringCódigo do cupom aplicado.

items[]

FieldTypeDescription
codestringRegistered main code (ERP).
barcodestringBarcode (GTIN / EAN).
quantityintQuantity requested.
unitPricenumberUnit price of the SKU (without discount).
totalAmountnumberTotal value of the SKU (with discounts applied).
discountPricenumberTotal discount value applied (not unit).
pricenumberTotal original value without discount.
subTotalAmountnumberTotal gross value of the item (before discounts).
isGiftbooleanIndicates whether the item is a gift.
giftMessagestringGift message (if applicable).
itemNotestringNote about the item.

buyer

FieldTypeDescription
documentTypeintDocument type: 1 = CPF, 2 = CNPJ.
cpfstringCustomer's CPF (if an individual).
cnpjstringCustomer's CNPJ (if a legal entity).
companyNamestringCorporate name (if a legal entity).
fullNamestringCustomer's full name.
emailstringCustomer's email address.
phoneNumberstringCustomer's phone number.
addressobjectBilling address.

deliveryAddress

FieldTypeDescription
streetstringStreet
numberstringNumber
complementstringComplement
neighborhoodstringNeighborhood
cepstringPostal Code
citystringCity
statestringState
fullAddressstringFull formatted address

dealer

FieldTypeDescription
dealerCodestringVendor or store code.
fullNamestringVendor name.
salesmanCpfstringVendor's CPF.
storeCnpjstringStore's CNPJ.
companyNamestringCompany or store name.

freight

FieldTypeDescription
referencestringCarrier name or code.
deliveryTimeintDelivery time (in days).
estimateDatestring (ISO)Estimated delivery date.
amountnumberShipping cost.

paymentList

FieldTypeDescription
nsustringUnique sequential number of the transaction.
acquirerApprovalCodestringAcquirer approval code.
quantityInstallmentsintNumber of installments.
amountnumberTotal payment amount.
paymentMethod.brandstringCard brand.
paymentMethod.typeintMethod type: 1 = Credit, 3 = Boleto, 6 = Pix.
paymentStatusintStatus: 0 = Unpaid, 5 = Pre-approved, 6 = Paid.

invoice

FieldTypeDescription
invoice.keystringElectronic invoice access code.
invoice.numberstringInvoice number.
invoice.xmlUrlstringXML invoice URL.
invoice.fileUrlstringPDF invoice URL.

tracking

FieldTypeDescription
tracking.trackingCodestringTracking code.
tracking.trackingLinkstringOrder tracking link.
tracking.carrierNamestringCarrier name.

pickingInfo

🚧

Picking feature need be able in Retailer Configurations.

Without picking feature able, this field will be 1 by default.

FieldTypeDescription
pickingInfo.packagesQuantityintQuantity of associated volumes/NF-e.

pickingInfo.packages[]

🚧

Packages feature need be able in Retailer Configurations.

FieldTypeDescription
idGuidPackage identifier.
namestringPackage name/description.
weightInKgnumberPackage weight in kg.
heightInCmnumberHeight in centimeters.
widthInCmnumberWidth in centimeters.
lengthInCmnumberLength in centimeters.
isFragilebooleanIndicates whether the package is fragile.
isRequiredSignaturebooleanRequires signature upon receipt.
items[].codestringCode of the item contained in the package.
items[].quantityintQuantity of items in the package.

Exemplo de retorno:

[
	{
		"id":"04a271fd-ba93-4393-bddd-4c5b69b473ec", -->id do pedido na plataforma de integração
		"createDate":"2021-05-06T18:14:11.1523482Z", -->data de criação
		"externalId":"1130180812765-01", --> id do pedido no martetplace
        "channel":"marketplace", --> canal de vendas
        "friendlyCode":"PD-JLC9FZ", --> Código amigável do pedido
        "cpfPickUp":null, --> CPF de retirada
        "cpfInvoice":"88119377515", -> CPF para fatura
        "invoiceUrl":null,
        "dealerCode":null,
        "feeAmount":0.0,
   		  "bonusAmount": 0.0,
        "isDelivery":true,--> Campo de definição se é entrega ou não (quando sim recebe true)
        "isCvvValidated":false,
        "maxPickUpTime":null,
        "status":2, --> Id do Status do pedido
        "buyer":{
            "cpf":"88119377515", 
            "phoneNumber":"0000-0000", 
            "deviceToken":null,
            "imageUrl":null,
            "gender":0,
            "dateOfBirth":null,
            "address":
        {
            "street":"Rua Juá",
            "number":"197",
            "complement":"ap 31",
            "neighborhood":"Saúde",
            "cep":"04138-020",
            "city":"São Paulo",
            "state":"SP",
            "latitude":null,
            "longitude":null,
            "reference":null,
            "label":null,
            "fullAddress":"Rua Juá, 157 ap 391 - Saúde - 04138-020 | São Paulo - SP",
            "id":"84ff853e-df72-4bc7-8271-cac98b83a653",
            "clientId":null,
            "createDate":"2021-05-06T18:14:11.1554661Z",
            "lastUpdate":"2021-05-06T18:14:11.1554661Z"
        },
            "fullName":"Implantacao Neomode",
            "email":"[email protected]",
            "id":"55a098af-5f45-4822-bea4-95c0b20c3532",
            "clientId":null,
            "createDate":"2021-05-06T18:14:11.1552374Z",
            "lastUpdate":"2021-05-06T18:14:11.1552374Z"},
            "invoice":
                        {
                            "key":null,
                            "number":null,
                            "serieNumber":0,
                            "totalAmount":0.0,
                            "xmlUrl":null,
                            "fileUrl":null,
                            "issuanceDate":"0001-01-01T00:00:00",
                            "id":"050e74dc-ddad-43c2-9f86-59d62cae3394",
                            "clientId":null,
                            "createDate":"2021-05-06T18:14:11.1527435Z",
                            "lastUpdate":"2021-05-06T18:14:11.1527435Z"
                        },
    "modality":null,
    "seller":
        {
        "cnpj":"01098883568879",
        "companyName":"CNPJ = 01098883568879",
        "pointSaleId":"marketplace",
        "whatsappPhoneNumber":null,
        "isEcommerce":false,
        "gatewayId":null,
        "credentialsString":"[email protected]",
        "distance":0.0,
        "processId":null,
        "hasFullCartStockAvailable":false,
        "integrationConfig":null,
        "workingHours":null,
        "address":
            {
                "street":null,
                "number":null,
                "complement":null,
                "neighborhood":null,
                "cep":null,
                "city":null,
                "state":null,
                "latitude":-20.4630729,
                "longitude":-54.6192893,
                "reference":null,
                "label":null,
                "fullAddress":",   -  -  |  - ",
                "id":"fc464623-7729-4628-bef3-aa4528d4a61f",
                "clientId":null,
                "createDate":"2020-11-19T11:45:36.7510524",
                "lastUpdate":null},
                "fullName":"Loja Balneário do Sul",
                "email":"[email protected]",
                "id":"1afddece-9e39-4583-a903-da3cb2788435",
                "clientId":"saj-baln-sul",
                "createDate":"2020-11-19T11:45:36.761738",
                "lastUpdate":"2021-05-06T18:14:11.1532158Z"
            },
        "freight":
                 {
                    "deliveryTime":0,--> Tempo de entrega em dias
                    "calculationKey":null,
                    "reference":null,
                    "description":null,
                    "amount":0.0,
                    "id":"7d2d4c7a-dd7d-4f10-8093-e02f0c301b7e",
                    "clientId":null,
                    "createDate":"2021-05-06T18:14:11.1558289Z",
                    "lastUpdate":"2021-05-06T18:14:11.155829Z"
                    },
         "voucher":null,
         "deliveryAddress":--> Dados de entrega
            {
                "street":"Rua Juá",
                "number":"197",
                "complement":"ap 31",
                "neighborhood":"Saúde",
                "cep":"04138-020",
                "city":"São Paulo",
                "state":"SP",
                "latitude":null,
                "longitude":null,
                "reference":null,
                "label":null,
                "fullAddress":"Rua Juá, 197 ap 31 - Saúde - 04138-020 | São Paulo - SP",
                "id":"15823a9d-b421-4d42-bd16-0a52e4a2565b",
                "clientId":null,
                "createDate":"2021-05-06T18:14:11.1565285Z",
                "lastUpdate":"2021-05-06T18:14:11.1565285Z"
            },
        "paymentInfo":
            {
                "externalOrderId":null,
                "externalFraudId":null,
                "externalRefundId":null,
                "externalCaptureId":null,
                "externalReversalId":null,
                "externalTransactionId":null,
                "nsu":null,
                "acquirerApprovalCode":null,
                "isCaptured":true,
                "isReversed":false,
                "isRefunded":false,
                "isAuthorized":true,
                "invoiceUrl":null,
                "acquirerMessage":"Pagamento assumido pela Yami",
                "bankCode":null,
                "bankSlipUrl":null,
                "bankSlipLine":null,
                "bankSlipExpirationDate":null,
                "statusMessage":null,
                "fraudStatusMessage":null,
                "amount":0.0,
                "quantityInstallments":1,
                "fraudStatus":0,
                "paymentStatus":6,
                "paymentMethod":
                    {
                        "info":"Pagamento externo",
                        "cardHolder":null,
                        "brand":null,
                        "finalNumber":null,
                        "binNumber":null,
                        "type":4,
                        "expiration":null,
                        "cvvHash":null,
                        "cvvEncrypted":null,
                        "number":null,
                        "token":null,
                        "externalId":null,
                        "externalCustomerId":null,
                        "modality":0,"id":"e69ff934-fff3-4f37-879a-024764e473ca",
                        "clientId":null,
                        "createDate":"2021-05-06T18:16:11.1763426Z",
                        "lastUpdate":"2021-05-06T18:16:11.1763426Z"
                    },
                "retryCount":0,
                "hasChangedProgrammatically":false,
                "receivingMethod":null,
                "splits":null,
                "id":"99bea3bf-dffb-4c0c-a39b-0dae6ac7921d",
                "clientId":null,
                "createDate":"2021-05-06T18:14:11.1561987Z",
                "lastUpdate":"2021-05-06T18:14:11.1561988Z"
    },
    "dealer":null,
    "items":--Dados dos Itens
        [
            {
                "quantity":2,
                "discountPrice":0.0,
                "sku":
                    {
                        "code":"366814",
                        "auxCode":"7891186101185",
                        "barcode":"7891186101185",
                        "name":"Único",
                        "imageUrl":null,
                        "productSku":"Meia Lupo Preta - Único",
                        "productCode":"419898",
                        "attributes":
                            [],
                        "product":
                            {
                                "code":"419898",
                                "name":"Meia Lupo Preta",
                                "complementaryName":null,
                                "imageUrl":null,
                                "unitPrice":14.99,
                                "unitOldPrice":14.99,
                                "unitWholesalePrice":0.0,
                                "wholesaleQuantity":0,
                                "defaultMaxInstallments":0,
                                "voucherMaxInstallments":null,
                                "maxInstallments":0,
                                "isRepriceProduct":false,
                                "id":"48949d45-37dd-4b25-b745-997f150a7361",
                                "clientId":"saj-baln-paqueta",
                                "createDate":"2021-05-06T18:14:11.2724467Z",
                                "lastUpdate":"2021-05-06T18:14:11.2724468Z"
                            },
                        "id":"e597b502-8137-4706-9b46-e7e4bc6328f1",
                        "clientId":"saj-baln-sul",
                        "createDate":"2021-01-25T19:39:43.93",
                        "lastUpdate":"2021-01-25T19:39:43.9666667"
                    },
            "isGift":false,
            "unitPrice":14.99,
            "subTotalAmount":29.98,
            "totalAmount":29.98,
            "price":29.98,
            "totalPrice":29.98,
            "id":"c8c0f6d4-e706-41fa-a549-f0b29e45ea9f",
            "clientId":null,
            "createDate":"2021-05-06T18:14:11.273168Z",
            "lastUpdate":"2021-05-06T18:14:11.273168Z"}],
            "steps":-->Histórico de status registrados do pedido
                    [
                        {
                            "description":"Pedido realizado",
                            "action":null,
                            "actionUrl":null,
                            "actionText":null,
                            "position":1.0,
                            "level":3,
                            "status":0,
                            "id":"1a9727ff-9023-48d4-888e-0d5ba4e94466",
                            "clientId":null,
                            "createDate":"2021-05-06T18:14:11.5737844Z",
                            "lastUpdate":"2021-05-06T18:14:11.5737846Z"
                        },
                        {
                            "description":"Pagamento confirmado",
                            "action":null,
                            "actionUrl":null,
                            "actionText":null,
                            "position":2.0,
                            "level":3,
                            "status":1,
                            "id":"fce576b5-0f38-4f2c-9ad4-334c83f75854",
                            "clientId":null,
                            "createDate":"2021-05-06T18:14:11.5738862Z",
                            "lastUpdate":"2021-05-06T18:14:11.5738862Z"
                        },
                        {
                            "description":"Aguardando nota fiscal",
                            "action":null,
                            "actionUrl":null,
                            "actionText":null,
                            "position":3.0,
                            "level":1,
                            "status":2,
                            "id":"8c7f0cb6-aafd-4a3b-b981-0f864fbdc5c2",
                            "clientId":null,
                            "createDate":"2021-05-06T18:14:11.5738951Z",
                            "lastUpdate":"2021-05-06T18:14:11.5738952Z"},
                        {
                            "description":"Em transporte",
                            "action":null,
                            "actionUrl":null,
                            "actionText":null,
                            "position":4.0,
                            "level":1,
                            "status":3,
                            "id":"32ff01ca-72be-491b-a029-877c3148dab4",
                            "clientId":null,
                            "createDate":"2021-05-06T18:14:11.5738964Z",
                            "lastUpdate":"2021-05-06T18:14:11.5738964Z"
                        },
                        {
                            "description":"Pedido finalizado",
                            "action":null,"actionUrl":null,
                            "actionText":null,
                            "position":5.0,
                            "level":1,
                            "status":4,
                            "id":"953f23fc-14f4-4684-90e9-6a412116f485",
                            "clientId":null,
                            "createDate":"2021-05-06T18:14:11.5738976Z",
                            "lastUpdate":"2021-05-06T18:14:11.5738976Z"
                        }
                    ],
                "actionLogs":
                    [
                        {
                            "title":null,
                            "displayMessage":"Pedido recebido na Lori",
                            "internalMessage":"order: 04a271fd-ba93-4393-bddd-4c5b69b473ec order create at Lori successful",
                            "issuer":null,
                            "urlLog":null,
                            "type":1,
                            "level":0,
                            "specificActionType":0,
                            "id":"ee3746e6-b414-4d6f-b2be-e0593c5f8956",
                            "clientId":null,
                            "createDate":"2021-05-06T18:14:11.5739745Z",
                            "lastUpdate":"2021-05-06T18:14:11.5739743Z"
                        },
                        {
                            "title":"Pagamento",
                            "displayMessage":"O pagamento será processado pelo parceiro externo",
                            "internalMessage":"order: 04a271fd-ba93-4393-bddd-4c5b69b473ec will be external payment",
                            "issuer":"Parceiro externo",
                            "urlLog":null,
                            "type":2,
                            "level":1,
                            "specificActionType":0,
                            "id":"211c6139-1306-4a82-b536-82d9c653c4d8",
                            "clientId":null,
                            "createDate":"2021-05-06T18:14:11.5841394Z",
                            "lastUpdate":"2021-05-06T18:14:11.574083Z"
                        }
                    ],
                    "buttons":
                        [],
                    "hasFeeInstallment":false,
                    "maxInstallmentsWithTax":1,
                    "maxVoucherInstallmentsWithoutTax":null,
                    "maxProductInstallmentsWithoutTax":null,
                    "maxInstallmentsWithoutTax":1,
                    "discountAmount":0.0,
                    "subTotalAmount":29.98,
                    "freightAmount":0.0,
                    "totalWithoutFeeAmount":29.98,
                    "totalAmount":29.98
                    }
                ]
Language
Credentials
OAuth2
URL