Criar ordens de compra

Através deste EndPoint você pode criar um pedido de compra para um armazém.

Uma ordem de compra é feita dentro de um armazém e é obrigatório que os bens que estão sendo associados façam parte do armazém. Por isso o parâmetro na url warehouse_code é o código do armazém ao qual se quer criar uma ordem de compra. Pode ser consultado aqui. (campo code)

Ao fazer pedidos de integração, as seguintes características devem ser levadas em consideração:

  • A moeda ou moeda com a qual o PO é gerado é a moeda associada por padrão com a empresa.
  • As condições são automaticamente selecionadas a partir das informações do fornecedor escolhido.

Parâmetros de entrada

A seguinte informação deve ser enviada no body da solicitação.

Parâmetro Tipo Obrigatório Descrição
document *Texto* Sim Referência do pedido de compra
code_third_party *Texto* Opcional Código do fornecedor do pedido de compra (fornecedor terceirizado ou prestador de serviços no Fracttal). [Pode ser consultado aqui. ](https://api.fracttal.com/reference/consulta-de-terceros)(campo *code*)
description_cost_center *Texto* Opcional Descrição do centro de custo. (Não é necessário enviar se for enviado o valor do centro de custo)
value_cost_center *Texto* Opcional Código do centro de custo. (Não é necessário enviar se for enviada a descrição do centro de custo)
date *Texto* Opcional Data de entrega. Deve ser enviado no formato 'AAAA-MM-DD'. Caso este campo não seja informado, por padrão é o momento da criação do pedido de compra no Fracttal
id_priority *Inteiro* Opcional 1: Muito alta 2: Alta 3: Média 4: Baixa 5: Muito baixa
description *Texto* Opcional Notas de ordem de compra
items *Array de objetos Json* Sim
Parâmetro Tipo de campo Descrição
code Text Código do artigo a associar na ordem de compra (deve estar associado ao armazém)
tax_name Text Nome do imposto
qty Texto Quantidade Solicitada
unit_cost Real Custo unitário. Deve ter aplicado o imposto que lhe estava associado
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 Descrição
id *Inteiro* ID do movimento
date *Date* Data de entrega
description *Texto* Descrição da entrada.
document *Texto* Referência
id_third_party *Texto* ID do terceiros
third_parties_name *Texto* Nome do terceiro
third_parties_code *Texto* Código de terceiros
id_cost_center *Texto* Id Centro de Custo
costs_center_description *Texto* Descrição do centro de custo
costs_center_value *Texto* Valor do centro de custo
folio_source *Texto* ID do movimento do armazém de origem
folio_target *Texto* Id da movimentação do armazém de destino
date_create *Texto* Data de criação do movimento
id_priority *Texto* Prioridade de identificação
priorities_description *Texto* Prioridade
id_currency *Número* Moeda de identificação
currency_description *Texto* Descrição da moeda
currency_symbol *Texto* Símbolo de moeda
movements_states_description *Texto* Descrição do status do movimento
movement_details *Arrays de objetos Json* Detalhe dos itens na ordem de compra

Detalhe do objeto movement_details

Parâmetro Tipo Descrição
id_item *Inteiro* Id do item
items_description *Texto* Descrição do item
code *Texto* Código do item
qty *Texto* Quantidade solicitada na ordem de compra
unit_cost *Texto* Custo unitário
total_cost *Texto* Custo total
tax_name *Texto* Descrição do tipo de imposto que se aplica

Exemplo:

Requisição: (POST)https://app.fracttal.com/api/warehouse_purchase_orders/1254

{
    "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"
	     }	
    ]
   
}
{
    "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
}
Language
Click Try It! to start a request and see the response here!