API de integração Mercos
API Reference
  1. API de integração Mercos
  2. Pedidos

Incluir um pedido

post
https://sandbox.mercos.com/api/v2/pedidos
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

📌 Header de resposta

Em caso de sucesso (201 - Created), o ID Mercos do recurso criado será retornado no header meuspedidosid.

Body Params
integer
required
Defaults to 7172892

Identificador único do cliente.

string

Data de criação do pedido. Pode ser diferente da data_emissao, já que um pedido pode ter sido criado em uma data e emitido em outra. Este campo somente será preenchido se for enviado no POST, pois representa a data em que o pedido foi criado (não confundir com a data de inserção no banco de dados)

string
required
Defaults to 2024-10-31

Data de emissão do pedido.

integer

ID do contato criado no Mercos.

integer

ID da transportadora.

integer

ID do vendedor que responsável pelo pedido

integer

ID da condição de pagamento. Deve ser informado somente se houver integração com a entidade Condições de Pagamento. Não deve ser utilizado junto com o campo condicao_pagamento.

integer

ID do tipo de pedido. Deve ser informado somente se houver integração com a entidade Tipo de Pedido.

integer

ID da forma de pagamento. Deve ser informado somente se houver integração com a entidade Formas de Pagamento.

integer

ID do endereço de entrega.

string

Código ou link de rastreamento do envio do pedido.

double

Valor do frete aplicado ao pedido.

string

Informações adicionais registradas no pedido.

extras
array of objects

Lista de campos extras associados ao pedido. A estrutura esperada pode ser consultada na seção Estrutura de Retorno de Campos Extras do Pedido.

extras
itens
array of objects

Lista de itens do pedido, conforme estrutura JSON definida na seção Parâmetros do JSON de envio do Item do Pedido. Se informado, deve conter pelo menos um item.

itens
string

Descrição da condição de pagamento em texto livre. Deve ser informado somente se não houver integração com a entidade Condições de Pagamento. Não deve ser utilizado junto com o campo condicao_pagamento_id.

integer | null

Identificador da representada. Opcional: quando não informado, o Mercos usa a representada associada à integração. Utilize este campo se a sua conta não é uma indústria com divisões. Se for, utilize divisao_id no lugar dele.

integer | null

Identificador da divisão. Opcional: quando não informado, o Mercos usa a divisão associada à integração. Utilize este campo se a sua conta é uma indústria com divisões. Nas demais contas, utilize representada_id.

Headers
string
required

Identifica sua aplicação.

string
required

Representa o cliente da sua aplicação.

Responses

Updated 4 months ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?