(POST) Criar Ordens de Compra

(POST) Criar Ordens de Compra

Mediante este EndPoint se pode criar uma ordem de compra a um armazém.

Uma ordem de compra se realiza dentro de um armazém e é obrigatório que os ativos que se estejam associando  façam parte do armazém.

Quando se realizam ordem de compra por integração, se deve ter em conta as seguintes características:

  • A divisa ou moeda com a que se gera a OC é a que tem associada por defeito a empresa.
  • As condições se selecionam automaticamente da informação do provedor que se eleja.

EndPoint
https://app.fracttal.com/api/warehouse_purchase_order/:warehouse_code

warehouse_code = Código do armazém

Método POST

Parâmetros Entrada

Parâmetro Tipo de campo Requerido Descrição
warehouse_code Texto Sim Código do Armazém
body JSON Opcional JSON com a informação necessária para a criação da OC

Parâmetros do body

Parâmetro Tipo de campo Requerido Descrição
document Texto Sim Referência da ordem de compra
code_third_party Text Opcional Código do provedor da ordem de compra (Terceiro de tipo provedor ou provedor de serviços em Fracttal)
description_cost_center Text Opcional Descrição do centro de custo. (Não é necessário enviar ou se envia o valor do centro de custo)
value_cost_center Text Opcional Código do centro de custo. (Não é necessário enviar ou se envia a descrição do centro de custo)
date Text Opcional Data de entrega. Deve ser enviada no formato 'YYYY-MM-DD'. Em caso de não ingressar este campo, por defeito é a hora de criação da ordem de compra no Fracttal
id_priority int Opcional 1: Muito Alta
2: Alta
3: Média
4: Baixa
5: Muito baixa
description Text Opcional Notas da ordem de compra
items Array de Json Sim
Parâmetro Tipo de campo Descrição
code Text Código do item a associar na ordem de compra (deve estar associado o armazém)
tax_name Text Nome do imposto
qty Texto Quantidade Solicitada
unit_cost Real Custo unitário. Deve ter aplicado o imposto que se associou.
total_cost Real Custo Total. Deve ser a multiplicação da quantidade e o custo unitário

Parâmetros de saída

Parâmetro Tipo de campo Descrição
id Integer Id do movimento
date date Data de entrega
description Text Descrição da entrada.
document Text Referência
id_third_party Text id do terceiro
third_parties_name Text Nome do terceiro
third_parties_code Text Código do terceiro
id_cost_center Text Id Centro de Custo
costs_center_description Text Descrição do centro de Custos
costs_center_value Text Valor do centro de Custos
folio_source Text Id do movimento do armazém fonte
folio_target Text Id do movimento do armazém de destino
date_create Text Data de criação do movimento
id_priority Text Id Prioridade
priorities_description Text Prioridade
id_currency Número Id divisa
currency_description Text Descrição da divisa
currency_symbol Text Símbolo da divisa
currency_symbol Text Símbolo da divisa
movements_states_description Text Descrição do estado do movimento

Exemplo:

Exemplo Petição:

EndPointhttps://app.fracttal.com/api/warehouse_purchase_orders/1254

Body

{
"document":"OC_325",
"code_third_party":"00063960000109",
"cost_center": "Activos",
"date":"2019-10-22",
"id_priority":"2",
"description":"Nota de OC mediante integración",
"items":[
{
"code":"DEST01",
"qty": "9",
"unit_cost":5000,
"tax_name": "IVA"
},
{
"code":"0005010000100222",
"qty": "15",
"unit_cost":9800,
"tax_name": "IVA"
}
]

}

Resposta

{
"success": true,
"message": "200",
"data": {
"id": "30",
"date": "2019-10-22",
"description": "Nota de OC mediante integración",
"document": "OC_325",
"id_third_party": 225,
"third_parties_name": "Walmart ",
"third_parties_code": "00063960000109",
"id_cost_center": 5,
"costs_center_description": "Activos",
"costs_center_value": "456465",
"folio_source": null,
"folio_target": "30",
"date_create": "2019-10-22T20:00:28.868832+00:00",
"id_priority": 2,
"priorities_description": "HIGH",
"id_currency": 4,
"currency_description": "Peso Colombiano",
"currency_symbol": "$",
"movements_states_description": "NOT_DELIVERED",
"movement_details": [
{
"id_item": 168,
"items_description": "VIDRIO OSCURO PARA CARETA SOLDADOR N°12 { 0005010000100222 }",
"code": "0005010000100222",
"qty": 15,
"unit_cost": 98700,
"total_cost": 1761800,
"tax_name": "IVA",
"tax_rate": 19
},
{
"id_item": 16,
"items_description": "Destornillador { DEST01 }",
"code": "DEST01",
"qty": 9,
"unit_cost": 5000,
"total_cost": 53550,
"tax_name": "IVA",
"tax_rate": 19
}
]
},
"total": 1
}