Crear ordenes 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. Es por esto que el parámetro en la url warehouse_code es el código del almacén al cual se le quiere crear una orden de compra. Se puede consultar aquí. (campo code)

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

La siguiente información debe ser enviada 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 (Tercero de tipo proveedor ó proveedor de servicios en Fracttal). Se puede consultar aquí. (campo code)

description_cost_center Texto Opcional Descripción del centro de costo. (No es necesario enviarlo si se envía la el valor del centro de costo)

value_cost_center Texto Opcional Código del centro de costo. (No es necesario enviarlo si se envía la description del centro de costo)

date Texto Opcional Fecha 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_priority Entero Opcional 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í

Parámetro	Tipo de campo	Descripción
code	Text	Código del item a asociar en la orden de compra (debe estar asociado al almacén)
tax_name	Text	Nombre del impuesto
qty	Texto	Cantidad Solicitada
unit_cost	Real	Costo unitario. Debe tener aplicado el impuesto que se le asoció
total_cost	Real	Costo Total.Debe ser la multiplicación de la cantidad y el costo unitario

Parámetros de salida

Parámetro	Tipo	Descripción
`id`	Entero	Id del movimiento
`date`	Date	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 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 Prioridad
`priorities_description`	Texto	Prioridad
`id_currency`	Entero	Id divisa
`currency_description`	Texto	Descripción de la divisa
`currency_symbol`	Texto	Símbolo de la divisa
`currency_symbol`	Texto	Símbolo de la divisa
`movements_states_description`	Texto	Descripción del estado del movimiento
`movement_details`	Arrays de objetos Json	Detalle de los items en la orden de compra

Detalle del objeto movement_details

Parámetro	Tipo	Descripción
`id_item`	Entero	Id del item
`items_description`	Fecha	Descripción del ítem
`code`	Texto	Código del item
`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"
	     }	
    ]
   
}

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