Fracttal →

Crear órdenes de compra

Mediante este EndPoint se puede crear una orden de compra a un almacén.

Una orden de compra se realiza dentro de un almacén y es obligatorio que los activos que se estén asociando hagan parte del almacén.

Cuando se realizan órdenes de compra por integración, se debe tener en cuenta las siguientes características:

  • La divisa o moneda con la que se genera la OC es la que tiene asociada por defecto la empresa.
  • Las condiciones se seleccionan automáticamente de la información del proveedor que se elija.

Parámetros de entrada

ParámetroTipoRequeridoDescripción
warehouse_codeTextoCódigo del Almacén
bodyJSONOpcionalJSON con la información necesaria para la creación de la OC

Parámetros del body

ParámetroTipoRequeridoDescripción
documentTextoReferencia de la orden de compra
code_third_partyTextoOpcionalCódigo del proveedor de la orden de compra (Tercero de tipo proveedor ó proveedor de servicios en Fracttal)
description_cost_centerTextoOpcionalDescripción del centro de costo. (No es necesario enviarlo si se envía la el valor del centro de costo)
value_cost_centerTextoOpcionalCódigo del centro de costo. (No es necesario enviarlo si se envía la description del centro de costo)
dateTextoOpcionalFecha de entrega. Debe ser enviada en el formato 'YYYY-MM-DD'. En caso de no ingresar este campo, por defecto es la hora de creación de la orden de compra en Fracttal
id_priorityEnteroOpcional1: Muy Alta
2: Alta
3: Media
4: Baja
5: Muy baja
descriptionTextoOpcionalNotas de la orden de compra
itemsArray de Json
ParámetroTipo de campoDescripción
codeTextCódigo del item a asociar en la orden de compra (debe estar asociado al almacén)
tax_nameTextNombre del impuesto
qtyTextoCantidad Solicitada
unit_costRealCosto unitario. Debe tener aplicado el impuesto que se le asoció
total_costRealCosto Total.Debe ser la multiplicación de la cantidad y el costo unitario

Parámetros de salida

ParámetroTipoDescripción
idEnteroId del movimiento
dateDateFecha de entrega
descriptionTextoDescripción de la entrada.
documentTextoReferencia
id_third_partyTextoid del tercero
third_parties_nameTextoNombre del tercero
third_parties_codeTextoCódigo del tercero
id_cost_centerTextoId Centro de Costos
costs_center_descriptionTextoDescripción del centro de Costos
costs_center_valueTextoValor del centro de Costos
folio_sourceTextoId del movimiento del almacén fuente
folio_targetTextoId del movimiento del almacén de destino
date_createTextoFecha de creación del movimiento
id_priorityTextoId Prioridad
priorities_descriptionTextoPrioridad
id_currencyNúmeroId divisa
currency_descriptionTextoDescripción de la divisa
currency_symbolTextoSímbolo de la divisa
currency_symbolTextoSímbolo de la divisa
movements_states_descriptionTextoDescripción del estado del movimiento

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

PROBAR CONEXION

Language