Crear órdenes de compra

post

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

Crea una orden de compra en un almacén de Fracttal.

Una orden de compra se realiza dentro de un almacén. Los activos asociados a la orden deben pertenecer al almacén indicado en la URL.

Endpoint

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

Parámetro de URL

Parámetro	Tipo	Requerido	Descripción
`warehouse_code`	Texto	Sí	Código del almacén al cual se le creará la orden de compra. Se puede consultar en Consultar almacenes, campo `code`.

Consideraciones

Cuando se crean órdenes de compra por integración, ten en cuenta lo siguiente:

La divisa o moneda de la orden de compra es la que la empresa tiene asociada por defecto.
Las condiciones se seleccionan automáticamente a partir de la información del proveedor elegido.

Parámetros de entrada

Envía la siguiente información en el body de la petición.

Parámetro	Tipo	Requerido	Descripción
`document`	Texto	Sí	Referencia de la orden de compra.
`code_third_party`	Texto	Opcional	Código del proveedor de la orden de compra. Debe ser un tercero de tipo proveedor o proveedor de servicios en Fracttal. Se puede consultar en Consulta de terceros, campo `code`.
`description_cost_center`	Texto	Opcional	Descripción del centro de costo. No es necesario enviarlo si se envía `value_cost_center`.
`value_cost_center`	Texto	Opcional	Código del centro de costo. No es necesario enviarlo si se envía `description_cost_center`.
`date`	Texto	Opcional	Fecha de entrega en formato `YYYY-MM-DD`. Si no se envía, Fracttal usa por defecto la hora de creación de la orden de compra.
`id_priority`	Entero	Opcional	ID de prioridad. Valores permitidos: `1` Muy alta, `2` Alta, `3` Media, `4` Baja, `5` Muy baja.
`description`	Texto	Opcional	Notas de la orden de compra.
`items`	Array de objetos JSON	Sí	Detalle de los ítems que se asociarán a la orden de compra.

Objetos de `items`

Parámetro	Tipo	Descripción
`code`	Texto	Código del ítem que se asociará a la orden de compra. El ítem debe estar asociado al almacén.
`tax_name`	Texto	Nombre del impuesto.
`qty`	Texto	Cantidad solicitada.
`unit_cost`	Real	Costo unitario. Debe tener aplicado el impuesto asociado.
`total_cost`	Real	Costo total. Debe ser la multiplicación de la cantidad por el costo unitario.

Parámetros de salida

Parámetro	Tipo	Descripción
`id`	Entero	ID del movimiento.
`date`	Fecha	Fecha de entrega.
`description`	Texto	Descripción de la entrada.
`document`	Texto	Referencia.
`id_third_party`	Texto	ID del tercero.
`third_parties_name`	Texto	Nombre del tercero.
`third_parties_code`	Texto	Código del tercero.
`id_cost_center`	Texto	ID del centro de costos.
`costs_center_description`	Texto	Descripción del centro de costos.
`costs_center_value`	Texto	Valor del centro de costos.
`folio_source`	Texto	ID del movimiento del almacén fuente.
`folio_target`	Texto	ID del movimiento del almacén de destino.
`date_create`	Texto	Fecha de creación del movimiento.
`id_priority`	Texto	ID de prioridad.
`priorities_description`	Texto	Prioridad.
`id_currency`	Entero	ID de divisa.
`currency_description`	Texto	Descripción de la divisa.
`currency_symbol`	Texto	Símbolo de la divisa.
`movements_states_description`	Texto	Descripción del estado del movimiento.
`movement_details`	Array de objetos JSON	Detalle de los ítems en la orden de compra.

Objeto `movement_details`

Parámetro	Tipo	Descripción
`id_item`	Entero	ID del ítem.
`items_description`	Texto	Descripción del ítem.
`code`	Texto	Código del ítem.
`qty`	Texto	Cantidad pedida en la orden de compra.
`unit_cost`	Texto	Costo unitario.
`total_cost`	Texto	Costo total.
`tax_name`	Texto	Descripción del tipo de impuesto que aplica.

Ejemplo

Petición

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

Respuesta

{
  "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

Loading…