Conhecimento Market Base de Conhecimento

Sincronizando Pedidos e-commerce

Este artigo faz parte do Manual do Integrador.

O pedido deve ser gravado no gestor quando já estiver pronto para emissão do documento fiscal.

1 Lista de preços

Primeiro será necessário saber qual lista de preço deve ser utilizada. Para isso use a URL indicada na imagem abaixo:

### consultar preços do vendedor

GET {{url}}vendedores/precos

Authorization: Bearer {{token}}

Esta URL vai indicar qual lista de preços pode ser utilizada em seus pedidos.

2 Plano de pagamento

No tópico acima vimos como obter uma lista de preços, junto com cada lista terá o plano de pagamento. Ele deverá ser informado no momento de lançar o pedido e também tem uma informação muito importante, se a mercadoria será paga na entrega.

Quando o atributo "PagoNaEntrega" não estiver habilitado, não crie o pedido sem ter a confirmação do pagamento.

Note que cada lista de preços possui um plano de pagamento, dessa forma não misture itens com planos de pagamento diferentes, visto que eles deverão ser enviados em pedidos separados nesse caso.

3 Pedido

Os pedidos só podem ser criados ou cancelados.

3.1 Criando um pedido

Ao criar um novo pedido será necessário informar os dados cadastrais de um cliente, como por exemplo seu endereço de entrega. Caso não exista ainda um cadastro para o cliente isso será feito automaticamente. O pedido possui um atributo chamado "Situacao", para acompanhar o seu andamento, os possíveis valores são:

1 - Em análise(1 / 3)

2 - Pronto para separação(2 / 3)

3 - Separado e encaminhado para entrega(3 / 3)

99 - Cancelado

Quando o pedido estiver na situação 3 já poderá ser consultado o documento fiscal dele em /pedidos/{id}/docfiscal

Segue um exemplo de como criar um pedido:

### Gravando um novo pedido para o cliente

POST {{url}}pedidos

Content-Type: application/json

Authorization: Bearer {{token}}

{

"lojaId": 1,

"cliente": {

"nome": "LORENCO LTDA - ME",

"cpfcnpj": "18395470990188",

"email": null,

"dddCelular": "047",

"celular": "999129966",

"telefoneFixo": null,

"enderecoEntrega": {

"uf": "SC",

"cidade": "LAGES",

"ibge": 4209300,

"bairro": "CENTRO",

"logradouroTipo": "RUA",

"logradouro": "PRESIDENTE NEREU RAMOS",

"numero": 333,

"cep": "88508870",

"complemento": null

},

"enderecoCobranca": null

},

"planoPgtoId": 56,

"pedidoVendedorId": 99249,

"itens": [

{

"produtoId": 35675,

"quantidade": 2,

"precoUnitario": 18.99,

"listaPrecoId": "PA770"

}

],

"parcelas": [

{

"numero": 1,

"entrada": true,

"valor": 12.66,

"vencimento": "2026-01-15T11:42:29.580Z"

},

{

"numero": 2,

"entrada": false,

"valor": 12.66,

"vencimento": "2026-01-20T11:42:29.580Z"

},

{

"numero": 3,

"entrada": false,

"valor": 12.66,

"vencimento": "2026-01-27T11:42:29.580Z"

}

]

}

NOTA: O atributo "pedidoVendedorId" é um campo para ser informado o número desse pedido no sistema do parceiro.

3.2 Consultando pedidos

Conforme os exemplos abaixo podemos consultar todos os dados com base no código do pedido no sistema Gestor:

### consultar um pedido

GET {{url}}pedidos/649686

Authorization: Bearer {{token}}

Também é possível consultar um resumo de vários pedidos:

### consultar resumo pedidos

GET {{url}}pedidos/resumo

Authorization: Bearer {{token}}

3.3 Cancelando um pedido

Para cancelar o pedido siga o exemplo abaixo:

DELETE {{url}}pedidos

Content-Type: application/json

Authorization: Bearer {{token}}

{

"id": 649686,

}

Não é permitido cancelar um pedido que já esteja nas seguintes situações:

3 - Separado e encaminhado para entrega(3 / 3)

99 - Cancelado