Nomes alternativos do fechamento
Os endereços wk_pos_checkout e wkposcheckout, equivalentes a pos_checkout, para os terminais já instalados.
Os terminais antigos fecham a venda por wk_pos_checkout ou wkposcheckout. Os dois endereços executam o mesmo código de Fechar a venda: mesmo corpo, mesma resposta, mesmos erros, e a mesma limitação (produto físico exige forma de envio, que esta rota não aceita). Em software novo use pos_checkout.
Exigem um usuário administrador. Com /api/v1.0 os ids são UUID; com /api são decimais.
/api/v1.0/wk_pos_checkoutAdminMesmo que pos_checkout, ids UUID
Igual a POST /api/v1.0/pos_checkout.
Corpo da requisição
scopestringobrigatórioplace_orderplace_order.order_agentstringobrigatórioproduct_infoarrayobrigatórioproduct_id, qty, is_free_product, selected_options.customer_infoobjectobrigatórioemail (obrigatório), user_id, firstname, lastname.payment_infoobjectpayment_type, o código da forma de pagamento.shipping_coststringpadrão: 0discountstringpadrão: 0order_commentstring/api/wk_pos_checkoutAdminMesmo que pos_checkout, ids decimais
Igual a POST /api/pos_checkout.
Corpo da requisição
scopestringobrigatórioplace_orderplace_order.order_agentstringobrigatórioproduct_infoarrayobrigatórioproduct_id, qty, is_free_product, selected_options.customer_infoobjectobrigatórioemail (obrigatório), user_id, firstname, lastname.payment_infoobjectpayment_type, o código da forma de pagamento.shipping_coststringpadrão: 0discountstringpadrão: 0order_commentstring/api/v1.0/wkposcheckoutAdminMesmo que pos_checkout, ids UUID
Igual a POST /api/v1.0/pos_checkout.
Corpo da requisição
scopestringobrigatórioplace_orderplace_order.order_agentstringobrigatórioproduct_infoarrayobrigatórioproduct_id, qty, is_free_product, selected_options.customer_infoobjectobrigatórioemail (obrigatório), user_id, firstname, lastname.payment_infoobjectpayment_type, o código da forma de pagamento.shipping_coststringpadrão: 0discountstringpadrão: 0order_commentstring/api/wkposcheckoutAdminMesmo que pos_checkout, ids decimais
Igual a POST /api/pos_checkout.
Corpo da requisição
scopestringobrigatórioplace_orderplace_order.order_agentstringobrigatórioproduct_infoarrayobrigatórioproduct_id, qty, is_free_product, selected_options.customer_infoobjectobrigatórioemail (obrigatório), user_id, firstname, lastname.payment_infoobjectpayment_type, o código da forma de pagamento.shipping_coststringpadrão: 0discountstringpadrão: 0order_commentstringExemplo de requisição
curl -X POST "$BASE_URL/api/v1.0/wk_pos_checkout" \
-u "$ADMIN_EMAIL:$API_KEY" \
-H "Content-Type: application/json" \
-d '{"scope":"place_order","order_agent":"caixa-01","product_info":[{"product_id":"d8a6c5e7-8e44-4055-a0e2-49014f5d17f6","qty":1}],"customer_info":{"user_id":"f12f30a9-cbec-40ba-98f1-b7fa8f2e8e10","email":"maria.souza@example.com","firstname":"Maria","lastname":"Souza"},"payment_info":{"payment_type":"pagamento-na-entrega"}}'Resposta
{
"status": 200,
"data": {
"success": true,
"message": "",
"order_data": { "order_id": "3f73310d-bfdd-4713-a664-305c08eda58b", "status": "O", "date": 1791749845, "error": [] }
}
}Todos os campos da resposta estão em Fechar a venda.
Erros
Os mesmos de Fechar a venda: erros de negócio com HTTP 200 e data.success: false, 401 sem credencial e 403 para quem não é administrador.