Criar ordens de compra

post

https://app.fracttal.com/api/inventories_adjustment/{warehouse_code}

Crie uma ordem de compra em um armazém da Fracttal.

Uma ordem de compra é criada dentro de um armazém. Os bens associados à ordem devem pertencer ao armazém informado na URL.

Endpoint

POST https://app.fracttal.com/api/warehouse_purchase_orders/{warehouse_code}

Parâmetro de URL

Parâmetro	Tipo	Obrigatório	Descrição
`warehouse_code`	Texto	Sim	Código do armazém no qual a ordem de compra será criada. Pode ser consultado em Consultar armazéns, campo `code`.

Considerações

Ao criar ordens de compra por integração, leve em conta as seguintes características:

A moeda usada para gerar a ordem de compra é a moeda associada por padrão à empresa.
As condições são selecionadas automaticamente a partir das informações do fornecedor escolhido.

Parâmetros de entrada

Envie as seguintes informações no body da solicitação.

Parâmetro	Tipo	Obrigatório	Descrição
`document`	Texto	Sim	Referência da ordem de compra.
`code_third_party`	Texto	Opcional	Código do fornecedor da ordem de compra, como terceiro fornecedor ou prestador de serviços na Fracttal. Pode ser consultado em Consulta de terceiros, campo `code`.
`description_cost_center`	Texto	Opcional	Descrição do centro de custo. Não é necessário enviar este campo se `value_cost_center` for enviado.
`value_cost_center`	Texto	Opcional	Código do centro de custo. Não é necessário enviar este campo se `description_cost_center` for enviado.
`date`	Texto	Opcional	Data de entrega no formato `AAAA-MM-DD`. Se este campo não for informado, a data será definida por padrão como o momento de criação da ordem de compra na Fracttal.
`id_priority`	Inteiro	Opcional	ID da prioridade. Valores permitidos: `1` Muito alta, `2` Alta, `3` Média, `4` Baixa, `5` Muito baixa.
`description`	Texto	Opcional	Notas da ordem de compra.
`items`	Array de objetos JSON	Sim	Detalhe dos itens que serão associados à ordem de compra.

Objetos de `items`

Parâmetro	Tipo	Descrição
`code`	Texto	Código do item que será associado à ordem de compra. O item deve estar associado ao armazém.
`tax_name`	Texto	Nome do imposto.
`qty`	Texto	Quantidade solicitada.
`unit_cost`	Real	Custo unitário. Deve ter aplicado o imposto associado.
`total_cost`	Real	Custo total. Deve ser a multiplicação da quantidade pelo custo unitário.

Parâmetros de saída

Parâmetro	Tipo	Descrição
`id`	Inteiro	ID do movimento.
`date`	Data	Data de entrega.
`description`	Texto	Descrição da entrada.
`document`	Texto	Referência.
`id_third_party`	Texto	ID do terceiro.
`third_parties_name`	Texto	Nome do terceiro.
`third_parties_code`	Texto	Código do terceiro.
`id_cost_center`	Texto	ID do 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	ID da prioridade.
`priorities_description`	Texto	Prioridade.
`id_currency`	Número	ID da moeda.
`currency_description`	Texto	Descrição da moeda.
`currency_symbol`	Texto	Símbolo da moeda.
`movements_states_description`	Texto	Descrição do status do movimento.
`movement_details`	Array de objetos JSON	Detalhe dos itens na ordem de compra.

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 aplicado.

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"
    }
  ]
}

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
}

Response

200

Language

Loading…