Pular para o conteúdo

Pedidos

A rota /api/integration/orders permite enviar pedidos para a Smarti Supply.

Method: POST

Essa rota aceita solicitações POST para Smarti Supply.

Headers

HeaderValueRequiredDescription
Content-Typeapplication/jsonYesThe content type of the request body.
AuthorizationBearer [access_token]YesThe authorization header.
X-Api-Keyxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxYesThe key to verify the message integrity.

Request

O corpo da solicitação será um objeto JSON com a seguinte estrutura:

Parameters

NameTypeDescriptionRequired
metadataobjetoO objeto de metadados.No
metadata.overwrite_allboolean:default:true Se deve sobrescrever todos os itens.No
metadata.page_total_countintO número total de páginas.No
metadata.total_recordsintO número total de registros.No
metadata.page_recordsintO número de registros por página.No
metadata.page_numberintO número da página atual.No
metadata.batch_idstringO ID do lote.No
itemsarrayO array de itens.Yes
items[].material_idstringO ID do material.Yes
items[].organization_codestringO código da organização (Filial/Depósito/Armazém).Yes
items[].order_idstringO código do pedido.Yes
items[].order_item_idstringO ID do item do pedido.Yes
items[].parcel_idintO ID da divisão de remessa.No
items[].delivery_datedata:Y-m-d A data de entrega.Yes
items[].reprogramming_datedata:Y-m-d A data de reprogramação.No
items[].required_datedata:Y-m-d A data de requerimento.Yes
items[].signstringO sinal (+ ou -).Yes
items[].quantityintA quantidade.Yes
items[].total_order_itemintA quantidade total do item do pedido.Yes
items[].supplier_idstringO ID do fornecedor.Yes
items[].statusstringO código do status.No
items[].requisition_idstringO ID da requisição.No
items[].requisition_item_idstringO ID do item da requisição.No
--------------------------
items[].materialobjetoO objeto do material.Yes se o Material for novo / No
items[].material.material_idstringO ID do material.Yes
items[].material.organization_codestringO código da organização.Yes
items[].material.merchandise_groupstringO grupo de mercadoria.Yes
items[].material.restricted_stockboolean:default:false A restrição de estoque.No
items[].material.blocked_stockboolean:default:false A bloqueio de estoque.No
items[].material.mesurement_unitstringA unidade de medida.Yes
items[].material.organization_stock_quantityintA quantidade de estoque.Yes
items[].material.min_sizeintO tamanho mínimo.Yes
items[].material.max_sizeintO tamanho máximo.Yes
items[].material.fixed_sizeintO tamanho fixo.Yes
items[].material.lead_timeintO tempo de lead.Yes
items[].material.roundingintA arredondamento.Yes
--------------------------
items[].supplierobjetoO objeto do fornecedor.Yes se o Fornecedor for novo / No
items[].supplier.supplier_idstringO ID do fornecedor.Yes
items[].supplier.namestringO nome do fornecedor.Yes
items[].supplier.contactstringNome do contato.No
items[].supplier.emailstringO e-mail do fornecedor.Yes
items[].supplier.send_emailboolean:default:true Se o fornecedor envia e-mail.No
--------------------------
items[].extras*arrayDados extras.No

Nota*: Os dados extras com as seguintes regras:

  • As chaves em CAPS serão mantidas do jeito que estão
  • Se palavras compostas por snake_case, serão convertidas com a primeira palavra em maiúscula e restantes em minúscula, com espaços em branco.
  • Se no valor existir um ’>’ o que vier antes será usado como referência para um icone e o que vier depois como cor.
  • Se no valor apos o ’>’ existir um ’&’ depois sera usado como está.

As chaves dos campos extra devem ser informadas a Smarti para correta configuração.

Example

{
"metadata": {
"overwrite_all": false,
"page_total_count": "2",
"total_records": "1791",
"page_records": "1000",
"page_number": "1",
"batch_id": "20240301-0001"
},
"items":[
{
"material_id": "000000000000100018",
"organization_code": "EI03",
"order_id": "4500633125",
"order_item_id": "000001",
"parcel_id": 1,
"delivery_date": "2022-11-08",
"reprogramming_date": "2023-05-17",
"required_date": "2022-12-07",
"sign": "+",
"quantity": 4600000000,
"total_order_item": 4600000000,
"supplier_id": "0000000439",
"status": "S",
"requisition_id": "",
"requisition_item_id": "",
"material": {
"material_id": "000000000000100018",
"organization_code": "EI03",
"merchandise_group": "001.0.001",
"restricted_stock": false,
"blocked_stock": false,
"mesurement_unit": "KG",
"organization_stock": 2792936000,
"min_size": 25000000,
"max_size": 0,
"fixed_size": 0,
"lead_time": 31,
"rounding": 25000000
},
"supplier": {
"supplier_id": "0000000439",
"name": "FABRICA DE CONFEÇOES LTDA",
"contact": "Joana",
"email": "k5TqG@example.com",
"send_email": false
},
"extras": [{
"SAP_status": "ph-arrows-left-right>Green&Em andamento",
"comprador_atribuido": "Juliana",
}]
}
]
}

Responses

CodeDescription
200Order created
400Invalid input
500Internal server error

200

{
"message": "Batch of orders received"
}

400

{
"error": {
"message": "Invalid input"
}
}

500