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
}