API_v4 - PUT Endpoints

A continuación podrá encontrar todas las acciones de la class=GET el cual le permitirá obtener el listado o información de su empresa en InterFuerza.

Acceso al API

A continuación podrá encontrar todas las acciones de la class=PUT el cual le permitirá guardar nueva información de su empresa en InterFuerza.

🚧

Recuerde que son dos variables que deben ser enviados junto con cualquier variable adicional en formato JSON al API de InterFuerza.

Conectándose con el API

Para realizar las comunicaciones con el API la misma es con HTTPS. Toda las peticiones deben ser enviadas a la dirección
https://app.interfuerza.com/api/v4/

La misma debe llevar el siguiente encabezado o HTTP Header:
X-IFX-Token:

Donde es el token obtenido en el siguiente enlace: Introducción

Acciones PUT:

PUT - leads

Crear un nuevo prospecto.

{

"class": "PUT",

"action": "leads",

"data": {

"Titulo":"Interes en Producto XYZ",

"Clase":"Persona Natural",

"RUC": "12345678",

"DV": "12",

"Empresa": "MI EMPRESA S.A.",

"Email": "[email protected]",

"Telefono_1": "+(507) 202-1234",

"Telefono_2": "",

"Cellular": "",

"Direccion": "Tumba muerto, Edificio Mi Empresa S.A.",

"Ciudad": "PANAMA",

"Estado": "PANAMA",

"Pais": "PANAMA",

"Credit_Term": "CREDIT",

"Due_Days": "30",

"Credit_Amount_Limit": "1000.00",

"Vendedor": "[email protected]",

"BirthDate": "1980-02-21",

"Taxable": true,

"Tipo_Contribuyente": "1",

"Clase": "Juridica",

"Name_First": "",

"Name_Second": "",

"LastName_First": "",

"LastName_Second": "",

"Asignado":"[usuario]",

"Fase":"",

"Fuente_Contacto":"LLAMADA",

"Fecha_Terminacion":"2018-12-30",

"Proximo_Contacto":"2018-03-14"

}

}
{

"class": "PUT",

"action": "leads",

"response": {

"response": "Success",

"id": "LEAD0043"

}

}

PUT - customers

Crear un nuevo cliente.

{

"class": "PUT",

"action": "customers",

"data": {

"Tipo": "CLIENTE",

"RUC": "12345678",

"DV": "12",

"Empresa": "MI EMPRESA S.A.",

"Email": "[email protected]",

"Status": "ACTIVE",

"Telefono_1": "+(507) 202-1234",

"Telefono_2": "",

"Cellular": "",

"Direccion": "Tumba muerto, Edificio Mi Empresa S.A.",

"Ciudad": "PANAMA",

"Estado": "PANAMA",

"Pais": "PANAMA",

"Empleados": "1",

"Industria": "Retail",

"Credit_Term": "CREDIT",

"Due_Days": "30",

"Credit_Amount_Limit": "1000.00",

"Vendedor": "[email protected]",

"BirthDate": "1980-02-21",

"Taxable": true,

"Tipo_Contribuyente": "1",

"Clase": "Juridica",

"Name_First": "",

"Name_Second": "",

"LastName_First": "",

"LastName_Second": ""

}

}
{

"class": "PUT",

"action": "customers",

"response": {

"response": "Success",

"id": "CUST0001", "Token": "SDA4324123qefqwef234"

}

}

PUT - product

Crear un nuevo producto o servicio, dependiendo del valor en Type.

{

"class":"PUT",

"action":"product",

"data":{

"Type":"PRODUCTO",

"Prod_Madre":"",

"UPC_Code":"23231313",

"Item_Number":"23eff23",

"Nombre":"Producto Prueba",

"Category_L1":"ALIMENTOS",

"Category_L2":"POLLO",

"Category_L3":"",

"Codigo_Externo":"123",

"Proveedor_Principal":"P0023",

"Setup":"0.00",

"Ultimo_Costo_Unidad":"3.00",

"Peso":"20.00",

"Detalle":"Producto de Prueba",

"Status":"ACTIVO",

"Marca":"BRAND1",

"Grosor":"2.0",

"Ancho":"2.0",

"Altura":"1.0",

"Largo":"2.4",

"Matrix":"N",

"Matrix_Child":"N",

"Color":"",

"Talla":"",

"Tax":"0.07",

"Volumen":"4.8",

"Lote":"",

"Expiracion":"",

"Has_Promotion":"",

"Has_Promotion_Type":"",

"Has_Promotion_Value":"",

"Has_Promotion_Default_Price":"",

"Has_Promotion_Date":"",

"Service_Price":"0",

"Service_Setup":"0",

"Prices_Definition":[

{

"Price_List":"FAMILIA",

"Price":"20.00"

},{

"Price_List":"Precio de Venta",

"Price":"23.00"

}

],

"Tags":["TAG1","TAG2"]
}

}
{"class":"PUT","action":"product","response":{"response":"Success","id":"PS0000546"}}

PUT - quotes

Crear una nueva cotización.

  • El código de cliente debe estar creado con anterioridad.
  • El nombre de la bodega debe ser idéntico al nombre obtenido en el listado de bodegas.
  • Las líneas de detalle pueden llevar o no Código. El mismo, si lleva, debe ser el id interno del producto.
{

"class": "PUT",

"action": "quotes",

"data": {

"id": "00001",

"Cliente": "C0001",

"Token" : "2131212ddsqeq123123",

"Bodega": "SLN BRIGOLF ARRIJAN",

"Status": "ACTIVE",

"Date": "2015-01-14",

"Expira": "2015-02-14",

"Comentario": null,

"SubTotal": "5.00",

"Discount": "0.00",

"Taxes": "0.00",

"Total": "5.00",

"extraData": "{JSON Valid String}",

"Reservar_Productos": "NO",

"Type": "SALES-TEAM",

"Vendedor": "[email protected]",

"Currency": "USD",

"Currency_Rate": "1.000000000",

"Lines": [{

"Codigo": "PS0000118",

"Descripcion": "CORTE DE CABELLO - GLORIA",

"Item_Number": "0002",

"Nombre": "CORTE DE CABELLO - GLORIA",

"Marca": "GLORIA",

"Category_L1": "SERVICIO SALON",

"Category_L2": "",

"Category_L3": "",

"Unidades": "1.00",

"Precio_Unitario": "5.0000",

"Discount": "0.00",

"DiscountFactor": "0.00",

"TaxID": "1",

"TaxName": "ITBMS",

"TaxFactor": "0.00",

"TaxValue": "0.0000",

"Total": "5.00"

}

]
}

}
{

"class": "PUT",

"action": "quotes",

"response": {

"response": "Success",

"id": "00012"

}

}

PUT - invoice

Crear una nueva factura.

  • El código de cliente debe estar creado con anterioridad.
  • El nombre de la bodega debe ser idéntico al nombre obtenido en el listado de bodegas.
  • Las líneas de detalle pueden llevar o no Código. El mismo, si lleva, debe ser el id interno del producto.
  • Si no llevan Código, debe enviar Account con la llave interna de la cuenta contable.
{

"class": "PUT",

"action": "invoice",

"data": {

"id": "00001",

"Cliente": "C0001",

"Token" : "2131212ddsqeq123123",

"Bodega": "SLN BRIGOLF ARRIJAN",

"Status": "ACTIVE",

"Date": "2015-01-14",

"Expira": "2015-02-14",

"Comentario": null,

"SubTotal": "5.00",

"Discount": "0.00",

"Taxes": "0.00",

"Total": "5.00",

"Reservar_Productos": "NO",

"Type": "SALES-TEAM",

"Vendedor": "[email protected]",

"Currency": "USD",

"Currency_Rate": "1.000000000",

"Lines": [{

"Codigo": "PS0000118",

"Descripcion": "CORTE DE CABELLO - GLORIA",

"Item_Number": "0002",

"Nombre": "CORTE DE CABELLO - GLORIA",

"Marca": "GLORIA",

"Category_L1": "SERVICIO SALON",

"Category_L2": "",

"Category_L3": "",

"Unidades": "1.00",

"Precio_Unitario": "5.0000",

"Discount": "0.00",

"DiscountFactor": "0.00",

"TaxID": "1",

"TaxName": "ITBMS",

"TaxFactor": "0.00",

"TaxValue": "0.0000",

"Total": "5.00"

}]
}

}
{

"class": "PUT",

"action": "invoice",

"response": {

"response": "Success",

"id": "00012"

}

}

PUT - credit notes

Crear nuevas notas de crédito

  • El código de cliente debe estar creado con anterioridad.
  • El nombre de la bodega debe ser idéntico al nombre obtenido en el lista de bodegas.
  • Las líneas de detalle pueden llevar o no Código. El mismo, si lleva, debe ser el id interno del producto.
  • Si no llevan Código, debe enviar Account con la llave interna de la cuenta contable
{

"class": "PUT",

"action": "credit-note",

"data": {

"id": "00001",

"Cliente": "C0023",

"Bodega": "Bodega Principal",

"Status": "ACTIVE",

"Date": "2024-01-08",

"Expira": "2024-02-14",

"Comentario": null,

"SubTotal": "5.00",

"Discount": "0.00",

"Taxes": "0.00",

"Total": "5.00",

"Reservar_Productos": "NO",

"Type": "SALES-TEAM",

"Currency": "USD",

"Currency_Rate": "1.000000000",

"Lines": [{

"Codigo": "PS0000004",

"Descripcion": "CORTE DE CABELLO - GLORIA",

"Item_Number": "3543246523",

"Nombre": "CORTE DE CABELLO - GLORIA",

"Marca": "GLORIA",

"Category_L1": "SERVICIO SALON",

"Category_L2": "",

"Category_L3": "",

"Unidades": "1.00",

"Precio_Unitario": "5.0000",

"Discount": "0.00",

"DiscountFactor": "0.00",

"TaxID": "1",

"TaxName": "ITBMS",

"TaxFactor": "0.00",

"TaxValue": "0.0000",

"Total": "5.00",
  
"Account": "ACC0079"

}]
}

}
{

"class": "PUT",

"action": "credit-note",

"response": {

"response": "Success",

"id": "SNC0062"

}

}

PUT - payments

Crear un nuevo pago.

  • El código de cliente debe estar creado con anterioridad.
  • Las formas de pago soportadas deben sumar el monto total del pago.
  • En caso de registrar un anticipo, debe colocar Type=ADVANCE y no enviar la variables de Facturas.
  • En caso de registrar un cobro de factura, la suma de los montos de las Facturas, deben sumar igual al campo Total.
{

"class": "PUT",

"action": "payment",

"data": {

"Cliente": "C0079",

"Token" : "2131212ddsqeq123123",

"Referencia": "COBRO0001",

"Fecha": "2017-12-01",

"Comentario": "Abono de Cliente",

"Cotizacion": "",

"Total": "200.00",

"Cambio": "0.00",

"Type": "BILL",

"Cash": {

"Cash_Amount": "50.00"

},

"Check": {

"Amount": "50.00",

"Bank": "Banco General",

"Authentication_Code": "AUT0101",

"Refference": "CK-001"

},

"Credit_Card": {

"Amount": "50.00",

"Type": "VISA",

"Number": "4324-XXXX-XXXX-0293",

"Authentication": "EC939289"

},

"Other": {

"Amount": "50.00",

"Name": "GIFTCARD",

"Reference": "GFT232323"

},

"Facturas": [{

"Factura": "FAC00001",

"Tipo": "Factura",

"Monto": 100

}, {

"Factura": "FAC00001",

"Tipo": "Factura",

"Monto": 100

}]
}

}
{

"class": "PUT",

"action": "payment",

"response": {

"response": "Success",

"id": "00012"

}

}

PUT - provider

Crear un nuevo proveedor.

{

"class":"PUT",

"action":"provider",

"data":{

"Empresa":"EMPRESA S.A.",

"Name_First":"Moises",

"Name_Second":"Elias",

"LastName_First":"Vega",

"LastName_Second":"Dominguez",

"RUC":"XXX",

"DV":"02",

"Telefono_1":"+507 202-1234",

"Telefono_2":"",

"Tipo":"LOCAL",

"Email":"[email protected]",

"Direccion":"Albrook Fields, Ed. BPA",

"Ciudad":"Panama",

"Estado":"Panama",

"Pais":"Panama",

"Empleados":"30",

"Credit_Term":"CREDIT",

"Due_Days":"30",

"Credit_Amount_Limit":"1000"

}

}
{

"class": "PUT",

"action": "provider",

"response": {

"response": "Success",

"id": "00012"

}

}

PUT - purchase

Crear una nueva compra.

  • El código de proveedor debe estar creado con anterioridad.
  • El nombre de la bodega debe ser idéntico al nombre obtenido en el listado de bodegas.
  • Las líneas de detalle pueden llevar o no Código. El mismo, si lleva, debe ser el id interno del producto o servicio.
  • Si no llevan Código, debe enviar Account con la llave interna de la cuenta contable a la que desea registrar el gasto.
{

"class":"PUT",

"action":"purchase",

"data":{

"Proveedor":"P0023",

"PO":"0001",

"Referencia":"0392",

"Fecha":"2017-12-01",

"Comentario":"Abono de Cliente",

"Cotizacion":"",

"SubTotal":"200.00",

"Otros_Tipo":"SHIPPING",

"Otros":"20.00",

"Impuestos":"11.00",

"Total":"231.00",

"Type":"PURCHASE",

"Proyecto":"",

"Lines":[{

"Codigo":"",

"Descripcion":"Prueba de Gasto",

"Unidades":"2",

"Precio_Unitario":"100.00",

"Total":"200.00",

"Account":"ACC00014"

}]
}

}
{

"class": "PUT",

"action": "purchase",

"response": {

"response": "Success",

"id": "00012"

}

}

PUT- purchase - credit - note

Crear nuevas notas de crédito
• El código de cliente debe estar creado con anterioridad.
• El nombre de la bodega debe ser idéntico al nombre obtenido en el listado de bodegas.
• Las líneas de detalle pueden llevar o no Código. El mismo, si lleva, debe ser el id interno del producto.
• Si no llevan Código, debe enviar Account con la llave interna de la cuenta contable.

{

"class":"PUT",

"action":"purchase_credit-note",

"data":{

"Provider":"P0002",

"PO":"0007",
 
"WareHouse":"Bodega Principal",

"Referencia":"0392",

"Date":"2024-02-09",

"Comentario":"Abono de Cliente",

"SubTotal":"200.00",

"Impuestos":"11.00",

"Total":"231.00",

"Type":"PURCHASE",

"Proyecto":"",

"Lines":[{

"Codigo":"PR05671",

"Descripcion":"Prueba de Gasto",

"Unidades":"2",

"Precio_Unitario":"100.00",

"Total":"200.00",

"Account":"ACC0001"

}]
}

}
{

"class": "PUT",

"action": "purchase_credit-note",

"response": {

"response": "Success",

"id": "CNC00020"

}

}

PUT - provider-payment

Crear un nuevo pago de proveedor.

  • El código de proveedor debe estar creado con anterioridad.
  • En el Payment_Type debe colocar el valor según el campo Tipo encontrado en la pantalla de creación de pago de proveedor.
  • En caso de registrar un anticipo, debe colocar Type=ADVANCE y no enviar la variables de Compras.
  • En caso de registrar un pago a compras, la suma de los montos de las Compras, deben sumar el total del campo Total.
  • El Bank_Account es el id interno de la cuenta contable de donde se sacaron los fondos para el pago a proveedor.
{

"class": "PUT",

"action": "provider-payment",

"data": {

"Proveedor": "C0079",

"Referencia": "PAY0001",

"Fecha": "2017-12-01",

"Comentario": "Pago a Proveedor",

"Total": "200.00",

"Type": "PURCHASE",

"Payment_Type":"ACH",

"Bank_Account":"ACC00007",

"Compras": [{

"Compra": "FAC00001",

"Tipo": "Compra",

"Monto": 100

}, {

"Compra": "FAC00001",

"Tipo": "Compra",

"Monto": 100

}]
}

}
{

"class": "PUT",

"action": "provider-payment",

"response": {

"response": "Success",

"id": "00012"

}

}

PUT - acc_journal

Crear un nuevo comprobante contable.

{

"class": "PUT",

"action": "acc_journal",

"data": {

"Referencia": "MAN0001",

"Date": "2017-12-01",

"Sec_Refference": "PLANILLA0001",

"Note": "Comprobante de Planilla",

"Lines": [{

"Account": "ACC0003",

"Description": "Registro de Caja",

"Amount": 100,

"Job": "ADMINISTRACION",

"Project": "",

"Acreedor": ""

}, {

"Account": "ACC0088",

"Description": "Registro de Salario",

"Amount": -100,

"Job": "ADMINISTRACION",

"Project": "",

"Acreedor": ""

}]
}

}
{

"class": "PUT",

"action": "acc_journal",

"response": {

"response": "Success",

"id": "ME-00000000821"

}

}

PUT - webusers-eshop

Create New Virtual Store User

Crear un nuevo usuario en la Tienda Virtual

  • Si la configuración de la tienda virtual en creación de usuario tiene que se debe asociar con email, el sistema buscará primero si el correo existe en un cliente y lo asociará de forma automática el nuevo usuario.
{

"class":"PUT",

"action":"webusers-eshop",

"data":{

"fromAPI":"AUTOGEN",

"email":"[email protected]",

"name":"Full Name of User",

"password":"<password string>"

}

}
{

"class":"PUT",

"action":"webusers-eshop",

"response":

{"response":"Success",

"user":"[email protected]}

}

Para mayor información o aclarar dudas, comunicarse al chat de atención al cliente que nuestros agentes le estará atendiendo.

PUT - warehouse_transfer

Este endpoint le permite crear Transferencias de Inventario en InterFuerza.

{
    "class": "PUT",
    "action": "warehouse_transfer",
    "data":{
        "Bodega_Origen":"Bodega Principal",
        "Bodega_Destino":"Tienda Virtual",
        "Fecha":"2022-02-15",
        "Comentario":"prueba de endpoint",
        "Procesar":"NO",
        "Lines": [{
            "Codigo":"PRO18479",
            "Unidades": 2,
            "Bodega_Origen":"Bodega Principal",
            "Bodega_Destino":"Tienda Virtual"
        }
        ]
    }
}
{
    "class": "PUT",
    "action": "warehouse_transfer",
    "response": {
        "response": "Success",
        "id": "102"
    }
}

PUT - inventory_adjustment

Este endpoint permite crear ajustes de inventarios en su cuenta de InterFuerza.

{
    "class": "PUT",
    "action": "inventory_adjustment",
    "data":{
        "Bodega":"Bodega Principal",
        "Fecha":"2022-02-09",
        "Categoria":"DEGUSTACIÓN",
        "Comentario":"prueba de endpoint",
        "Procesar":"YES",
        "Lines": [{
            "Codigo": "PS0000562",
            "Unidades": -2,
            "Costo": 10.00
        },{
            "Codigo":"PRO18544",
            "Unidades": -3,
            "Costo": ""
        }
        ]
    }
}
{
    "class": "PUT",
    "action": "inventory_adjustment",
    "response": {
        "response": "Success",
        "id": "AI-236"
    }
}

👍

Configuración contable

En ajuste de inventario las cuentas son tomadas de la cuenta de inventario del producto contra la cuenta configurada en Administrador de Tablas - Categorías de Inventario, según la categoría enviada en la petición PUT.

PUT - purchase_order

Este endpoint permite crear ordenes de compra a proveedor en su cuenta de InterFuerza.

{
    "class": "PUT",
    "action": "purchase_order",
    "data":{
        "Bodega":"Bodega Principal",
        "Fecha":"2022-02-10",
        "Proveedor":"P0064",
        "Comentario":"prueba de endpoint",
        "Moneda":"CRC",
        "Cambio":"",
        "Lines": [{
            "Codigo": "PS0000562",
            "Unidades": 3,
            "Costo":7.75
        },{
            "Codigo": "PRO18544",
            "Unidades": 4,
            "Costo":9.99
        }
        ]
    }
}
{
    "class": "PUT",
    "action": "purchase_order",
    "response": {
        "response": "Success",
        "id": "10145"
    }
}

👍

Codigo de producto y proveedor.

Recuerde que puede utilizar los endpoint de GET providers y products para obtener los valores id de proveedores y productos para ser enviados en este PUT.

📘

Nuevos Endpoints

De requerir nuevos endpoints no contemplados en esta V4, por favor no dude en escribirnos al chat de soporte o al correo [email protected].