Create Order

Order creation method

Request body example

{
    "receiver_name": "Nome",
    "receiver_lastname": "Sobrenome",
    "receiver_address": "Rua Chico Mendes",
    "receiver_address_number": "105",
    "receiver_address_complement": "Apto 22 bloco C",
    "receiver_address_reference": "Prox a padaria",
    "receiver_neighborhood": "Parque Imperial",
    "receiver_city": "Barueri",
    "receiver_state": "São Paulo",
    "receiver_country": "Brasil",
    "receiver_zipcode": "06462350",
    "receiver_email": "[email protected]",
    "receiver_phone_area": "11",
    "receiver_phone": "111111111",
    "receiver_phone2_area": "11",
    "receiver_phone2": "111111111",
    "payer_name": "Nome",
    "payer_lastname": "Sobrenome",
    "payer_address": "Rua Chico Mendes",
    "payer_address_number": "105",
    "payer_address_complement": "Apto 22 bloco C",
    "payer_additional_info": "Próximo a padaria",
    "payer_neighborhood": "Parque Imperial",
    "payer_city": "Barueri",
    "payer_state": "São Paulo",
    "payer_country": "Brasil",
    "payer_zipcode": "06462350",
    "payer_email": "[email protected]",
    "payer_phone_area": "11",
    "payer_phone": "111111111",
    "payer_phone2_area": "11",
    "payer_phone2": "111111111",
    "payer_cpf": "000.000.000-00",
    "payer_cnpj": "00.000.000/0001-00",
    "payer_company_name": "Razão social",
    "payer_tax_id": "00000000000",
    "payment_intermediary": "00.000.000/0001-00",
    "sale_intermediary": "00.000.000/0001-00",
    "intermediary_seller_id": "seller@marketplace",
    "currency": "BRL",
    "delivery_type": "standard",
    "expected_delivery_date": "2024-07-16T03:00:00.000Z",
    "expected_send_date": "2024-07-17T18:08:34.000Z",
    "receiver_schedule_date": "2016-11-05",
    "receiver_schedule_period": "morning",
    "subtotal": 54.81,
    "shipping": 10.99,
    "discount": 0,
    "tax": 0,
    "total": 65.80,
    "total_paid": 66.80,
    "original_id": "200-0008-474654",
    "auto_reserve": true,
    "ack": false,
    "user_client_id": "129",
    "sub_status": "waiting_expedition",
    "status": "pending",
    "channel": "MercadoLivre",
    "channel_account": "Pluggto",
    "commission": {
        "comment": "gold_special",
        "fixed": 0,
        "tax": 24.04,
        "total_charged": 10.68
    },
    "payments": [
        {
            "payment_type": "credit",
            "payment_installments": "2",
            "payment_method": "Nome do método como enviado pelo canal de venda",
            "payment_total": 66.80,
            "payment_quota": 33.40,
            "payment_interest": 1.00,
            "external": 82624426955
        }
    ],
    "items": [
        {
            "variation": {
                "sku": "1776924"
            },
            "name": "Prancha Chapinha Mallory Ultra Liss Ion 110V Cor Preto",
            "sku": "parent-1631600",
            "original_sku": "parent-1631600",
            "price": 41.83,
            "quantity": 1,
            "discount": 0,
            "tax": 15.22,
            "total": 41.83,
            "price_code": "Preço Saúde 28.06",
            "photo_url": "https://s3-sa-east-1.amazonaws.com/pluggto/5496/5496_74802d0c-764b-46f0-b978-485264535886.png",
            "category": "Beleza > Acessórios para Cabelos > Chapinhas",
            "supplier_id": "136",
            "stock_code": "warehouse_1",
            "place_code": "98",
            "commission": {
                "fixed": 0,
                "tax": 23.02,
                "comment": "gold_special",
                "total_charged": 9.63
            }
        },    
        {
            "name": "Creme De Hidratação Skala Amido Milho 1Kg",
            "sku": "188289",
            "original_sku": "188289",
            "price": 12.98,
            "quantity": 1,
            "discount": 0,
            "tax": 2.30,
            "total": 12.98,
            "place_code": "98",
            "stock_code": "warehouse_1",
            "photo_url": "https://s3-sa-east-1.amazonaws.com/pluggto/5496/5496_74802d0c-764b-46f0-b978-485264535886.png",
            "category": "cabelos > tratamento",
            "commission": {
                "fixed": 0,
                "tax": 3.02,
                "comment": "gold_special",
                "total_charged": 1.05
            }
          }
    ],
    "shipments": [
        {
            "label_type": "own_contract",
            "shipping_company": "Correios",
            "shipping_method": "PAC",
            "estimate_delivery_date": "2024-07-16T03:00:00.000Z"
        }
    ]
}

Request object has the following properties:

AttributeTypeDescription
receiver_namestringReceiver name
receiver_lastnamestringReceiver lastname
receiver_address_numberstringReceiver address numbe
receiver_addressstringReceiver address
receiver_address_complementstringReceiver address complement
receiver_address_referencestringReceiver address reference
receiver_neighborhoodstringReceiver neighborhood
receiver_citystringReceiver city
receiver_statestringReceiver state
receiver_countrystringReceiver country
receiver_emailstringReceiver email
receiver_zipcodestringReceiver zipcode
receiver_phone_areastringReceiver phone area
receiver_phonestringReceiver phone
receiver_phone2_areastringReceiver phone2 area
receiver_phone2stringReceiver phone2
payer_namestringPayer name
payer_lastnamestringPayer lastname
payer_addressstringPayer address
payer_address_numberstringPayer address number
payer_address_complementstringPayer address complement
payer_additional_infostringPayer additional info
payer_neighborhoodstringPayer neighborhood
payer_citystringPayer city
payer_statestringPayer state
payer_countrystringPayer country
payer_zipcodestringPayer zipcode
payer_emailstringPayer email
payer_phone_areastringPayer phone area
payer_phonestringPayer phone
payer_phone2_areastringPayer phone(2) area
payer_phone2stringPayer phone2
payer_cpfstringPayer CPF
payer_tax_idstringPayer's CPF or Inscrição Estadual (i.e)
payer_cnpjstringPayer CNPJ
payer_company_namestringPaying company name
total_paidnumberTotal paid by buyer
shippingnumberShipping paid
subtotalnumberSubtotal
discountnumberDiscount
taxnumberTotal order tax
totalnumberTotal
ackbooleanOrder receipt confirmation field
statusstringOrder status
sale_intermediarystringCNPJ of the sales intermediary
payment_intermediarystringCNPJ of the payment intermediary
intermediary_seller_idstringSeller ID, User or email that identifies the seller in the marketplace
user_client_idstringPlugg.to user ID
original_idstringoriginal order number (Enter your system number)
expected_send_datestringExpected send date
expected_delivery_datestringExpected delivery date
receiver_schedule_datestringReceiver schedule date
receiver_schedule_periodstringReceiver schedule period
Values:
morning
afternoon
night
stock_codestringProduct stock table name
price_codestringProduct price table name
auto_reservebooleanReserves product inventory by sending the value as "true"
paymentsobjectArray with payment information
payment_typestringcredit
debit
ticket
voucher
transfer
payment_installmentsintegerNumber of installments
payment_methodstringName of payment method
payment_quotanumberValue of installments
payment_interestnumberPayment interest
externalstringPayment transaction ID or NSU
shipmentsobjectArray with shipping information
shipping_companystringShipping company
shipping_methodstringShipping method
track_codestringTracking code
externalstringInform the order number
delivery_typestringstandard
express
onehour
pickup
economy
guaranteed
scheduled
international
fulfillment
currencystring'BRL', // Brasil
'ARS', // Argentina
'VEF', // VENEZUELA
'MXN', // MEXICO
'MXV', // MEXICO
'MCR', // COSTA RICA
'COP', // COLOMBIA
'BOB', // BOLIVIA
'ARS', // EQUADOR
'EUR', // EURO
'UYU', // URUGUAI
'CAD', // CANADA
'CLP', // CHILE
'CRC', // COSTA RICA
'PYG', // GUARANY
'PEN',// PERU
'PAB',// PANAMA
'GBP', // UNITeD KINGTON
'AUD',//AUSTRALIA
'CUP',// CUBA
'CUC',// CUBA
'USD'] // EUA
channelstringOrder sales channel
channel_accountstringChannel account
label_typestringLabel type
Values:
manual
third_contract
fulfillment
own_contract
pickup_store
drop_shipping
Language
Click Try It! to start a request and see the response here!