FRACTTAL API

(POST) Criar Pedidos de Compra

Usando este 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 ativos que estão sendo associados se tornem parte do Armazém.

Quando as ordens de compra são feitas por integração, as seguintes características devem ser levadas em conta:

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

 

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

warehouse_code = Código do Armazém

Método POST

Parâmetros de Entrada

Parâmetro Tipo de campo Obrigatório 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 Corpo

Parâmetro Tipo de campo Obrigatório Descrição
document Texto Sim Referência do pedido de compra
code_third_party Text Opcional Código do provedor da Ordem de Compra(Terceiro no Fracttal)
cost_center Text Opcional Descrição do centro de custos
date Text Opcional Data de entrega.Deve ser enviada no formato 'YYYY-MM-DD'. Se você não preencher este campo, por padrão, é a hora de criação do pedido de compra no Fracttal
id_priority int Opcional 1: Muy 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 para associar na ordem de compra (debe estar asociado al almacén)
tax_name Text Nome do imposto
qty Texto Quantidade solicitada
unit_cost Real Custo unitário.Você deve aplicar o imposto associado a ele
total_cost Real Custo total.Deve ser a multiplicação da quantidade e do custo unitário

Parâmetros de saída

Parâmetro Tipo de campo Descrição
id_movement Integer Id da movimentação
folio_source Text Id do movimentação do armazém fonte
folio_target Text Id de movimentação do armazém de destino
date date Data de entrega
description Text Descrição da entrada.
document Text Referência
movements_types_description Text Tipo de Movimentação
movements_states_description Text Descrição do estado de movimentação
warehouses_source_description Text Armazém Fonte
third_parties_name Text Nome do terceiro
costs_center_description Text Centro de Custos
responsible_description Text Responsável
priorities_description Text Prioridade
date_create Text Data de criação do movimento
third_parties_code Text Código do terceiro
third_parties_address Text Direção do Terceiro
third_parties_telephone_1 Text Telefone 1 do terceiro
third_parties_telephone_2 Text Telefone 2 do terceiro
third_parties_email Text E-mail do terceiro
number_details Número Quantidade de itens da movimentação

Exemplo:

Exemplo de Petição:

EndPoint: https://app.fracttal.com/api/warehouse_purchase_orders/1254

Corpo

{  
   "document":"DOC2INTEGRACION",
   "code_third_party":"09452513000108",
   "cost_center":"EQUIPO ASERCOP",
   "date":"2018-07-22",
   "id_priority":3,
   "description":"Notas de OC",
   "items":[  
      {  
         "code":"1234",
         "tax_name":"Exento",
         "qty":"2",
         "unit_cost":6000,
         "total_cost":12000
      }
   ]
}

Exemplo de Resposta:

{
    "success": true,
    "message": "200",
    "data": {
        "id": 202,
        "id_company": 69,
        "id_movement_type": 10,
        "id_warehouse_source": null,
        "id_warehouse_target": 2,
        "date": "2018-07-22",
        "description": "Notas de OC",
        "document": "DOC2INTEGRACION",
        "id_third_party": 93,
        "id_cost_center": 11,
        "id_responsible": null,
        "folio_source": null,
        "folio_target": "5",
        "id_movement_state": 3,
        "id_priority": 3,
        "date_create": "2018-07-23T19:41:46.25175+00:00",
        "id_condition": null,
        "id_currency": 4,
        "exchange_value": null,
        "id_work_orders_tasks": null,
        "id_movement_reference": null,
        "folio_return": 6
    },
    "total": 1
}