### GET /api/v1/inventario/guia Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/guia/index.html Retrieves a list of all guides created in the system. ```APIDOC ## GET /api/v1/inventario/guia ### Description Devuelve un listado con todas las Guias creadas en el sistema. ### Method GET ### Endpoint https://api.contifico.com/sistema/api/v1/inventario/guia ### Parameters #### Query Parameters - **cedula_chofer** (varchar) - Optional - Cedula del chofer de la guia. - **transportista_id** (varchar) - Optional - Identificador de la persona transportista en el sistema. - **fecha_emision** (date) - Optional - Fecha de emision de la guia de remision. - **electronico** (boolean) - Optional - Indica si la guia esta marcada como electronica. - **autorizacion** (varchar) - Optional - Numero de autorizacion de la guia. - **nombre_chofer** (varchar) - Optional - Nombre del chofer asignado a la guia. - **numero_documento** (varchar) - Optional - Numero de documento asociado a la guia. - **fecha_fin** (date) - Optional - Fecha fin para el envio de la guia. - **pos** (varchar) - Optional - Identificador del pos en el sistema. - **bodega_id** (varchar) - Optional - Identificador de la bodega en el sistema. - **id** (varchar) - Optional - Identificador de la guia de remision en el sistema. - **nombre_despachador** (varchar) - Optional - Nombre del despachador asignado a la guia. - **fecha_inicio** (date) - Optional - Fecha fin para el envio de la guia. - **ordencompraventa_id** (varchar) - Optional - Identificador de la orden de compra venta en el sistema. - **descripcion** (text) - Optional - Descripcion de la guia de remision. - **direccion_partida** (varchar) - Optional - Direccion de partida desde la cual se emite la guia. - **estado** (varchar) - Optional - Estado de la guia de remision (E:emitido, A:anulado). - **placa** (varchar) - Optional - placa del vehiculo asignado a la guia de remision. - **adicional1** (varchar) - Optional - Valor del campo adicional1 de la guia de remision. - **adicional2** (varchar) - Optional - Valor del campo adicional2 de la guia de remision. - **destinatario** (object) - Optional - Objeto contenedor de la informacion del destinatario. - **documento_id** (varchar) - Optional - Identificador del documento asociado a la guia en el sistema. - **codigo_destino** (varchar) - Optional - Codigo de destino de la guia. - **direccion** (varchar) - Optional - Direccion a la cual se enviara la guia. - **ruta** (varchar) - Optional - Ruta a la cual se enviara la guia. - **destinatario_id** (varchar) - Optional - Identificador de la persona destinataria a la guia en el sistema. - **motivo** (varchar) - Optional - Descripcion del motivo por el cual se envia la guia. - **detalle** (object) - Optional - Objeto contenedor de los detalles de los productos de la guia. - **cantidad** (decimal) - Optional - Cantidad del producto en el detalle de la guia (7 int, 6 decimal)max. - **serie** (varchar) - Optional - Serie del producto en el detalle de la guia. - **producto_id** (varchar) - Optional - Identificador del producto en el sistema. - **fecha_expiracion** (date) - Optional - Fecha de expiracion del producto en el detalle. - **nombre_manual** (varchar) - Optional - Nombre manual del producto en el detalla de la guia. - **lote** (varchar) - Optional - Campo para modulo especifico. ### Response #### Success Response (200) - **cedula_chofer** (null) - Cedula del chofer de la guia. - **transportista_id** (string) - Identificador de la persona transportista en el sistema. - **fecha_emision** (string) - Fecha de emision de la guia de remision. - **electronico** (boolean) - Indica si la guia esta marcada como electronica. - **autorizacion** (string) - Numero de autorizacion de la guia. - **nombre_chofer** (null) - Nombre del chofer asignado a la guia. - **numero_documento** (string) - Numero de documento asociado a la guia. - **fecha_fin** (string) - Fecha fin para el envio de la guia. - **pos** (null) - Identificador del pos en el sistema. - **bodega_id** (string) - Identificador de la bodega en el sistema. - **id** (string) - Identificador de la guia de remision en el sistema. - **nombre_despachador** (null) - Nombre del despachador asignado a la guia. - **fecha_inicio** (string) - Fecha fin para el envio de la guia. - **ordencompraventa_id** (null) - Identificador de la orden de compra venta en el sistema. - **descripcion** (string) - Descripcion de la guia de remision. - **direccion_partida** (string) - Direccion de partida desde la cual se emite la guia. - **estado** (string) - Estado de la guia de remision (E:emitido, A:anulado). - **placa** (string) - placa del vehiculo asignado a la guia de remision. - **adicional1** (string) - Valor del campo adicional1 de la guia de remision. - **adicional2** (null) - Valor del campo adicional2 de la guia de remision. - **destinatario** (object) - Objeto contenedor de la informacion del destinatario. - **documento_id** (string) - Identificador del documento asociado a la guia en el sistema. - **codigo_destino** (string) - Codigo de destino de la guia. - **direccion** (string) - Direccion a la cual se enviara la guia. - **ruta** (string) - Ruta a la cual se enviara la guia. - **destinatario_id** (string) - Identificador de la persona destinataria a la guia en el sistema. - **motivo** (string) - Descripcion del motivo por el cual se envia la guia. - **detalle** (array) - Objeto contenedor de los detalles de los productos de la guia. - **cantidad** (string) - Cantidad del producto en el detalle de la guia (7 int, 6 decimal)max. - **serie** (null) - Serie del producto en el detalle de la guia. - **producto_id** (string) - Identificador del producto en el sistema. - **fecha_expiracion** (null) - Fecha de expiracion del producto en el detalle. - **nombre_manual** (string) - Nombre manual del producto en el detalla de la guia. - **lote** (null) - Campo para modulo especifico. #### Response Example ```json [ { "cedula_chofer": null, "transportista_id": "P9aQ6KKkYUo11bDM", "fecha_emision": "20/07/2021", "electronico": true, "autorizacion": "", "nombre_chofer": null, "numero_documento": "001-001-000000001", "fecha_fin": "20/07/2021", "pos": null, "bodega_id": "5xmbmnlncWoodoKM", "id": "N5wboAk3zhvVVexE", "nombre_despachador": null, "fecha_inicio": "20/07/2021", "ordencompraventa_id": null, "descripcion": "Entrega producto 2007", "direccion_partida": "Fransisco segura y la 40", "estado": "E", "placa": "3232", "adicional1": "valoradicional", "adicional2" : null, "destinatario": { "documento_id": "P9aQWOWYOGHo11dD", "codigo_destino": "123", "direccion": "Edificio las camaras", "ruta": "Norte", "destinatario_id": "P9aQ6KKkYUo11bDM", "motivo": "Envio de mercaderia", "detalle": [ { "cantidad": "1.0", "serie": null, "producto_id": "9jaKOzR4zT4yyak5", "fecha_expiracion": null, "nombre_manual": "", "lote": null } ] } } ] ``` ``` -------------------------------- ### Example: Crossing Document with Delivery Service Account (Glovo) Source: https://github.com/contifico/contifico.github.io/blob/master/registro/cruces/index.html Example demonstrating how to use the 'tipo' query parameter for specific delivery services like Glovo. ```http POST https://api.contifico.com/sistema/api/v1/documento/7ujk93jdhsieu839/cruce_cuenta/?tipo="GL" ``` -------------------------------- ### Example: Crossing Document with General Accounting Account Source: https://github.com/contifico/contifico.github.io/blob/master/registro/cruces/index.html Example of how to specify the 'tipo' query parameter to cross a document with any general accounting account in the system. ```http POST https://api.contifico.com/sistema/api/v1/documento/7ujk93jdhsieu839/cruce_cuenta/?tipo="CTA" ``` -------------------------------- ### Get Document List Source: https://context7.com/contifico/contifico.github.io/llms.txt Retrieve a list of all documents in the account, with options to filter by document type, date, and associated person. The example shows how to get client documents issued on a specific date. ```bash # Obtener todos los documentos de clientes emitidos en una fecha específica curl -X GET "https://api.contifico.com/sistema/api/v1/registro/documento/?tipo_registro=CLI&fecha_emision=24/01/2019" \ -H "Authorization: TU_API_TOKEN" \ -H "Content-Type: application/json" ``` ```json { "id": "usdjcbjsydhcsjd", "documento": "001-001-000000251", "tipo_documento": "FAC", "tipo_registro": "CLI", "fecha_emision": "17/05/2021", "total": "11200.0", "iva": "12.00", "subtotal_12": "10000.0", "subtotal_0": "0.0", "estado": "P", "electronico": true, "cliente": { "ruc": "0922054366001", "cedula": "0922054366", "razon_social": "Nombres del Cliente", "email": "cliente@contifico.com" } } ``` -------------------------------- ### Example Inventory Response Source: https://context7.com/contifico/contifico.github.io/llms.txt Example JSON response for an inventory movement, showing details like ID, code, type, date, and status. ```json [ { "id": "JXPnaz67BimaO2yN", "codigo": "EGR 202006000017", "bodega_id": "MZN5wbo2fKaxEO0g", "tipo": "EGR", "fecha": "16/06/2020", "generar_asiento": false, "estado": "G", "descripcion": "Factura prueba", "total": "0.0", "detalles": [ { "producto_id": "PQEMaxGqKhQe5GBk", "precio": "125.0", "cantidad": "20.0" } ] } ] ``` -------------------------------- ### Example Payroll Response Source: https://context7.com/contifico/contifico.github.io/llms.txt Example JSON response structure for a payroll query, detailing income, expenses, and total payment for an employee. ```json [{ "anio": "2021", "mes": "6", "tipo_pago": "TRANSFERENCIA", "nombre_persona": "miguel", "cedula": "0950490458", "fecha": "01/07/2021", "dias_trabajados": "30", "total_ingresos": "575.0", "total_egresos": "47.25", "total_pago": "527.75", "comprobante": "202107000002", "num_cuenta": "242342", "detalles": [ { "nombre": "SUELDO", "total": "500.0", "tipo": "INGRESO" }, { "nombre": "9.45% IESS", "total": "47.25", "tipo": "EGRESO" }, { "nombre": "DÉCIMO TERCERO", "total": "41.67", "tipo": "INGRESO" }, { "nombre": "DÉCIMO CUARTO", "total": "33.33", "tipo": "INGRESO" } ] }] ``` -------------------------------- ### Example Inventory Movement Response Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/movimientos/index.html An example JSON response when retrieving an inventory movement. It shows the structure and fields returned by the API. ```JSON { "codigo": "EGR 202006000017", "bodega_id": "MZN5wbo2fKaxEO0g", "tipo": "EGR", "fecha": "16/06/2020", "generar_asiento": false, "pos": null, "detalles": [ { "serie": null, "producto_id": "PQEMaxGqKhQe5GBk", "edicion": null, "precio": "125.0", "cantidad": "20.0" }, { "serie": null, "producto_id": "OoLqdP1Njf5el4Gp", "edicion": null, "precio": "72.0", "cantidad": "10.0" } ], "maneja_venta": null, "descripcion": "Factura prueba", "total": "0.0", "estado": "G", "id": "JXPnaz67BimaO2yN", "bodega_destino_id": null, "codigo_interno": null } ``` -------------------------------- ### Create Guide of Remission - JSON Payload Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/guia/index.html Use this JSON payload to create a new Guide of Remission via the API. Ensure all required fields are correctly populated. ```json { "cedula_chofer": null, "transportista_id": "qlwKe582Ou0d31RZ", "fecha_emision": "19/11/2019", "electronico": true, "autorizacion": "", "nombre_chofer": null, "numero_documento": "001-001-000000003", "fecha_fin": "19/11/2019", "pos": "cf1c2ed9-e6bf-469c-ab5c-0bc21fc5a2e8", "bodega_id": "2Q5xmbmZws5doKM7", "nombre_despachador": null, "fecha_inicio": "19/11/2019", "ordencompraventa_id": null, "descripcion": "sad", "direccion_partida": "asds", "estado": "E", "placa": "gfc123", "destinatario": { "documento_id": null, "codigo_destino": "", "direccion": "SIN DIRECCION", "ruta": "", "destinatario_id": "GOjZdy8ZJUNbJ4mz", "motivo": "sadads", "detalle": [ { "cantidad": "150.0", "serie": null, "producto_id": "2Q5xmbmxzT5aoKM7", "fecha_expiracion": null, "nombre_manual": "", "lote": null } ] } } ``` -------------------------------- ### Create Inventory Income Source: https://context7.com/contifico/contifico.github.io/llms.txt Use this endpoint to register new product entries into the inventory. Ensure the 'tipo' is set to 'ING'. ```bash curl -X POST "https://api.contifico.com/sistema/api/v1/movimiento-inventario/" \ -H "Authorization: TU_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "tipo": "ING", "fecha": "01/01/2019", "bodega_id": "ljMEegJAHq0dQ5g3", "descripcion": "detalle ingreso", "detalles": [ { "producto_id": "RYWb4xYKNhz0bZ1m", "precio": "10.0", "cantidad": "1.0" }, { "producto_id": "RYWb4xYKNhz0bZ1m", "precio": "1.0", "cantidad": "15.0" } ] }' ``` -------------------------------- ### GET /roles Source: https://github.com/contifico/contifico.github.io/blob/master/rrhh/rol/index.html Retrieves information about roles. This endpoint can be used to get the role of a person. ```APIDOC ## GET /roles ### Description Retrieves information about roles, specifically the role assigned to a person. ### Method GET ### Endpoint /roles ### Query Parameters - **personId** (string) - Required - The ID of the person to retrieve the role for. ### Response #### Success Response (200) - **role** (string) - The role assigned to the person. #### Response Example ```json { "role": "Administrator" } ``` ``` -------------------------------- ### Crear un Producto Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/producto/index.html Creates a new product in the system. ```APIDOC ## POST /api/productos ### Description Creates a new product. ### Method POST ### Endpoint /api/productos ### Parameters None ### Query Parameters None ### Request Body - **name** (string) - Required - The name of the product. - **description** (string) - Optional - A description of the product. - **price** (number) - Required - The price of the product. ### Request Example { "name": "Keyboard", "description": "Mechanical keyboard", "price": 75.00 } ### Response #### Success Response (201) - **id** (integer) - The unique identifier for the newly created product. - **name** (string) - The name of the product. - **description** (string) - A description of the product. - **price** (number) - The price of the product. #### Response Example { "id": 2, "name": "Keyboard", "description": "Mechanical keyboard", "price": 75.00 } ``` -------------------------------- ### Get Product List Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/producto/index.html Use this endpoint to retrieve all products configured in the system. The response includes detailed information for each product. ```json [ { "porcentaje_iva": 12, "costo_maximo": null, "descripcion_departamento": null, "imagen": "", "minimo": "3.0", "para_comisariato": true, "indicador_peso": null, "descripcion": "COMPUTADORA 11\"", "generacion_automatica": false, "cuenta_costo_id": null, "pvp2": "250.0", "tipo": "PRO", "fecha_creacion": "20/08/2020", "id": "lY4erkB4vtrVa2Lz", "tipo_producto": "SIM", "pvp3": "300.0", "codigo_proveedor": "Colección 2019", "pvp1": "200.0", "descripcion_familia": null, "id_integracion_proveedor": null, "para_supereasy": true, "nombre": "LAPTOP DELL SRS PREMIUM SOUND", "codigo_sap": "000000000040009213", "descripcion_jerarquia": null, "pvp_manual": false, "codigo_barra": "000000011114", "pvp_comisariato": "3.50", "pvp4": "32.5", "cuenta_venta_id": "6x01dNXK8QfMaX7W", "categoria_id": "5onPeR2nBil9ep1v", "peso_hasta": null, "pvp_peso": null, "jerarquia": null, "departamento": null, "para_pos": true, "familia": null, "marca_id": null, "marca_nombre": null, "estado": "A", "categoria_comisariato_id": null, "cuenta_compra_id": null, "personalizado1": null, "peso_desde": null, "personalizado2": null, "codigo": "00001", "nombre_producto_base": null, "pvp_supereasy": "3.35", "variantes": null, "producto_base_id":null, "detalle_variantes": [ { "valor_id":null, "variante_id": "MZN5wbo2fDqaxEO0" } ], "lead_time": null, "cantidad_stock": "-5.0" }, ... ] ``` -------------------------------- ### GET /api/v1/producto/ Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/producto/index.html Retrieves a list of all products created in the system. This endpoint returns an array of product objects, each containing detailed information. ```APIDOC ## GET /api/v1/producto/ ### Description Devuelve un listado con todos los productos creados en el sistema. ### Method GET ### Endpoint https://api.contifico.com/sistema/api/v1/producto/ ### Parameters #### Query Parameters (No query parameters are specified in the provided text) #### Request Body (This endpoint does not accept a request body) ### Response #### Success Response (200) - **porcentaje_iva** (SmallIntegerField) - Valor de porcentaje de IVA que tiene el producto (0, 12, null). - **costo_maximo** (decimal) - Valor de costo máximo que puede tener el producto (7 int, 6 decimal)max. - **descripcion_departamento** (varchar) - Descripción de departamento de Mi Comisariato. (Modulo adicional) - **imagen** (obj) - Objeto Foto relacionado al producto. - **minimo** (decimal) - Valor mínino de stock que debe estar disponible (7 int, 6 decimal)max. - **para_comisariato** (boolean) - Indicador si el producto se usa para comisariato. (Modulo adicional) - **indicador_peso** (varchar) - Indicador de balanza (0:no es de balanza, 1:requiere peso, 2:por cantidad). (Modulo adicional) - **generacion_automatica** (boolean) - Variable de control para determina si el producto se utiliza en Orden de Compra. - **cuenta_costo_id** (varchar) - Identificador de la cuenta costo en el sistema. - **pvp2** (decimal) - Precio de venta 2 (7 int, 6 decimal)max. - **tipo** (varchar) - Tipo de producto (PRO:Producto, SER:Servicio). - **fecha_creacion** (date) - Fecha de creacion del producto. - **id** (varchar) - Identificador del producto en el sistema. - **tipo_producto** (varchar) - Subtipo del tipo Producto (SIM:simple, COM:combo, COP:compuesto, PRO:produccion) - **pvp3** (decimal) - Precio de venta 3 (7 int, 6 decimal)max. - **codigo_proveedor** (varchar) - Código utilizado para catalogo de productos. - **pvp1** (decimal) - Precio de venta 1 (7 int, 6 decimal)max. - **id_integracion_proveedor** (varchar) - Identificador de la persona proveedor en el sistema. - **para_supereasy** (boolean) - Indicador si el producto se usa para supereasy. (Modulo adicional) - **nombre** (varchar) - Nombre del producto. - **codigo_sap** (varchar) - Código de producto registrado desde SAP. (Modulo adicional) - **descripcion_jerarquia** (varchar) - Descripción de jerarquía de Mi Comisariato. (Modulo adicional) - **pvp_manual** (boolean) - Variable de control para determina si el producto utiliza precio manual. - **codigo_barra** (varchar) - Secuencia que representa el codigo de barras de un producto. - **pvp_comisariato** (decimal) - precio de venta de Mi Comisariato (7 int, 6 decimal)max. (Modulo adicional) - **pvp4** (decimal) - Precio de venta 4 (7 int, 6 decimal)max. - **cuenta_venta_id** (varchar) - Identificador de la cuenta contable asignada para la venta en el sistema. - **categoria_id** (varchar) - Identificador de la categoria en el sistema. - **peso_hasta** (decimal) - Valor de peso final para balanza. (Modulo adicional) - **pvp_peso** (decimal) - Valor de venta de peso para balanza (7 int, 6 decimal)max. (Modulo adicional) - **jerarquia** (varchar) - jerarquía del producto de en Mi Comisariato. (Modulo adicional) - **departamento** (varchar) - identificador de departamento de Mi Comisariato. (Modulo adicional) - **para_pos** (boolean) - Variable de control para determina si el producto se utiliza en POS. - **familia** (varchar) - (No description provided for this field) - **detalle_variantes** (array) - (No description provided for this field) - **lead_time** (null) - (No description provided for this field) - **cantidad_stock** (decimal) - (No description provided for this field) #### Response Example ```json [ { "porcentaje_iva": 12, "costo_maximo": null, "descripcion_departamento": null, "imagen": "", "minimo": "3.0", "para_comisariato": true, "indicador_peso": null, "descripcion": "COMPUTADORA 11\"", "generacion_automatica": false, "cuenta_costo_id": null, "pvp2": "250.0", "tipo": "PRO", "fecha_creacion": "20/08/2020", "id": "lY4erkB4vtrVa2Lz", "tipo_producto": "SIM", "pvp3": "300.0", "codigo_proveedor": "Colección 2019", "pvp1": "200.0", "descripcion_familia": null, "id_integracion_proveedor": null, "para_supereasy": true, "nombre": "LAPTOP DELL SRS PREMIUM SOUND", "codigo_sap": "000000000040009213", "descripcion_jerarquia": null, "pvp_manual": false, "codigo_barra": "000000011114", "pvp_comisariato": "3.50", "pvp4": "32.5", "cuenta_venta_id": "6x01dNXK8QfMaX7W", "categoria_id": "5onPeR2nBil9ep1v", "peso_hasta": null, "pvp_peso": null, "jerarquia": null, "departamento": null, "para_pos": true, "familia": null, "marca_id": null, "marca_nombre": null, "estado": "A", "categoria_comisariato_id": null, "cuenta_compra_id": null, "personalizado1": null, "peso_desde": null, "personalizado2": null, "codigo": "00001", "nombre_producto_base": null, "pvp_supereasy": "3.35", "variantes": null, "producto_base_id": null, "detalle_variantes": [ { "valor_id": null, "variante_id": "MZN5wbo2fDqaxEO0" } ], "lead_time": null, "cantidad_stock": "-5.0" }, ... ] ``` ``` -------------------------------- ### Product Creation Request Body Example Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/producto/index.html This JSON object demonstrates the structure and fields required when creating a product via the API. Note that some fields are optional or module-specific. ```json { "codigo_barra": "000000011115", "porcentaje_iva": "12", "tipo": "PRO", "categoria_id": "xgArb6B7wsPObyR4", "minimo": "3.0", "pvp1": "250.0", "pvp2": "300.0", "pvp3": "200.0", "pvp4": "200.0", "pvp_manual": false, "descripcion": "COMPUTADORA 11\"", "nombre": "LAPTOP DELL SRS PREMIUM SOUND 3333", "codigo": "00024", "estado": "A", "para_supereasy": false, "para_comisariato": true, "codigo_sap": "000000000040009212", "pvp_comisariato": "8.20", "categoria_comisariato_id": "wXrr2QS6Kd7Zn68U" } ``` -------------------------------- ### Consultar Productos Source: https://github.com/contifico/contifico.github.io/blob/master/registro/sri/index.html Returns a list of all products created in the system. Use this endpoint to fetch product data. ```json [ { "codigo_barra": "000000011114", "porcentaje_iva": 12, "categoria_id": "5onPeR2nBil9ep1v", "minimo": "3.0", "pvp2": "250.0", "pvp3": "300.0", "pvp1": "200.0", "pvp_manual": false, "descripcion": "COMPUTADORA 11\"", "nombre": "LAPTOP DELL SRS PREMIUM SOUND", "codigo": "00001", "estado": "A", "id": "lY4erkB4vtrVa2Lz", "cantidad_stock": "-5.0" }, ... ] ``` -------------------------------- ### Create Product API Endpoint Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/producto/index.html Use this POST endpoint to create a new product in the system. Ensure the request body contains all necessary product data. ```http POST https://api.contifico.com/sistema/api/v1/producto/ ``` -------------------------------- ### Electronic Document Status Response Example Source: https://github.com/contifico/contifico.github.io/blob/master/registro/documentoelectronico/index.html This is an example of the JSON response received when querying the status of an electronic document. It includes the document ID, record type, document type, and its current authorization state. ```json { "documento_id": "MRYWb4j7ViRmeZ1m", "tipo_registro": "CLI", "tipo_documento": "FAC", "estado": "Autorizado" } ``` -------------------------------- ### Get Product Stock by Warehouse Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/producto/index.html Use this GET request to retrieve the stock of a product for each warehouse associated with a Contifico point of sale. The response is a JSON array detailing warehouse name, ID, and stock quantity. ```http GET https://api.contifico.com/sistema/api/v1/producto//stock/ ``` ```json [ { "bodega_nombre": "Bodega Principal", "bodega_id": "BQ9pdBB26H52d8KE", "cantidad": 5 }, { "bodega_nombre": "Bodega Ventas", "bodega_id": "OgDGe79XJc17bn2x", "cantidad": 10 } ] ``` -------------------------------- ### Create Client Document (Invoice) Source: https://context7.com/contifico/contifico.github.io/llms.txt Create a new sales invoice in the system, including details for products and associated payments. This endpoint is used for creating standard client documents. ```bash curl -X POST "https://api.contifico.com/sistema/api/v1/documento/" \ -H "Authorization: TU_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "pos": "ceaa9097-1d76-4eb8-0000-6f412fa0297b", "fecha_emision": "01/11/2015", "tipo_documento": "FAC", "documento": "001-001-000008089", "estado": "P", "autorizacion": "0123456789", "cliente": { "ruc": "0922054366001", "cedula": "0922054366", "razon_social": "Nombres del Cliente", "telefonos": "0988800001", "direccion": "Direccion cliente", "tipo": "N", "email": "cliente@contifico.com", "es_extranjero": false }, "vendedor": { "ruc": "0904728680001", "cedula": "0904728680", "razon_social": "Nombres del Vendedor", "tipo": "N", "email": "vendedor@contifico.com" }, "descripcion": "FACTURA 8040", "subtotal_0": 0.00, "subtotal_12": 1.35, "iva": 0.16, "ice": 0.00, "servicio": 0.00, "total": 1.51, "detalles": [{ "producto_id": "RZxg87rxLh9Mb1pV", "cantidad": 1.00, "precio": 1.00, "porcentaje_iva": 12, "porcentaje_descuento": 0.00, "base_cero": 0.00, "base_gravable": 1.00, "base_no_gravable": 0.00 }], "cobros": [{ "forma_cobro": "TC", "monto": 1.51, "numero_cheque": "4567897", "tipo_ping": "D" }] }' ``` ```json { "id": "MRYWb4j7ViRmeZ1m", "mensaje": "Documento creado exitosamente" } ``` -------------------------------- ### Crear Producto Source: https://github.com/contifico/contifico.github.io/blob/master/registro/sri/index.html Provides the format for sending data to create a new product. Requires parameters like `categoria_id`, `nombre`, `codigo`, and `estado`. ```json { "codigo_barra": "000000011115", "porcentaje_iva": "12", "categoria_id": "xgArb6B7wsPObyR4", "minimo": "3.0", "pvp2": "250.0", "pvp3": "300.0", "pvp1": "200.0", "pvp_manual": false, "descripcion": "COMPUTADORA 11\"", "nombre": "LAPTOP DELL SRS PREMIUM SOUND 3333", "codigo": "00024", "estado": "A" } ``` -------------------------------- ### GET /sistema/api/v1/turismo/isla Source: https://github.com/contifico/contifico.github.io/blob/master/turismo/islas/index.html Retrieves a list of all islands created in the system. ```APIDOC ## GET /sistema/api/v1/turismo/isla ### Description Devuelve un listado con todas las islas creadas en el sistema ### Method GET ### Endpoint https://api.contifico.com/sistema/api/v1/turismo/isla ### Response #### Success Response (200) - **isla** (string) - Identifier for the island. - **dia_numero** (integer) - Day number associated with the island. - **id** (string) - Unique identifier for the island record. #### Response Example ```json [ { "isla": "STF", "dia_numero": 0, "id": "Q8J0yelYfoaER7OY" }, { "isla": "PLZ", "dia_numero": 1, "id": "2Q5xmbmwh5eoKM7W" } ] ``` ``` -------------------------------- ### GET /api/v1/marca// Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/marca/index.html Retrieves a specific brand by its ID. ```APIDOC ## GET /api/v1/marca// ### Description Returns a brand with the requested ``. ### Method GET ### Endpoint https://api.contifico.com/sistema/api/v1/marca// ### Parameters #### Path Parameters - **ID** (varchar) - Required - The unique identifier of the brand to retrieve. ### Request Body None ### Response #### Success Response (200) - **nombre** (varchar) - The name of the brand. - **id** (varchar) - The system identifier for the brand. #### Response Example ```json { "nombre": "Toyota", "id": "Q8J0yelYfoaER7OY" } ``` ``` -------------------------------- ### Obtener Listado de Productos Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/producto/index.html Retrieves a list of all products available in the system. ```APIDOC ## GET /api/productos ### Description Retrieves a list of all products. ### Method GET ### Endpoint /api/productos ### Query Parameters None ### Request Body None ### Response #### Success Response (200) - **products** (array) - A list of product objects. - **id** (integer) - The unique identifier for the product. - **name** (string) - The name of the product. - **description** (string) - A description of the product. - **price** (number) - The price of the product. #### Response Example { "products": [ { "id": 1, "name": "Laptop", "description": "High performance laptop", "price": 1200.50 } ] } ``` -------------------------------- ### Get Document Payments Source: https://context7.com/contifico/contifico.github.io/llms.txt Retrieve payment information for a specific document. ```APIDOC ## Get Document Payments ### Description Retrieve payment information for a specific document. ### Method GET ### Endpoint https://api.contifico.com/sistema/api/v1/documento/{documentId}/cobro/ ### Parameters #### Path Parameters - **documentId** (string) - Required - The ID of the document whose payments are to be retrieved. ### Response #### Success Response (200) - Returns an array of payment objects. Each object may contain: - **forma_cobro** (string) - Payment method. - **numero_comprobante** (string) - Payment voucher number. - **monto** (string) - Payment amount. - **fecha** (string) - Payment date. - **numero_cheque** (string) - Check number (if applicable). - **id** (string) - Payment record ID. ### Response Example ```json [ { "forma_cobro": "CQ", "numero_comprobante": "CHEQUE", "monto": "0.5", "fecha": "23/08/2021", "numero_cheque": "21312312", "id": "O8bY956LKhAWWb7j" } ] ``` ### Request Example ```bash curl -X GET "https://api.contifico.com/sistema/api/v1/documento/MRYWb4j7ViRmeZ1m/cobro/" \ -H "Authorization: TU_API_TOKEN" \ -H "Content-Type: application/json" ``` ``` -------------------------------- ### POST /sistema/api/v1/movimiento-inventario/ Source: https://github.com/contifico/contifico.github.io/blob/master/inventario/movimientos/index.html Creates a new inventory movement. Specify the 'tipo' for the movement (ING, EGR, TRA, AJU). ```APIDOC ## POST /sistema/api/v1/movimiento-inventario/ ### Description Creates a new inventory movement. Specify the 'tipo' for the movement (ING, EGR, TRA, AJU). ### Method POST ### Endpoint `https://api.contifico.com/sistema/api/v1/movimiento-inventario/` ### Parameters #### Request Body - **tipo** (varchar) - Required - Type of inventory movement (ING: income, EGR: expense, TRA: transfer, AJU: cost adjustment). - **fecha** (date) - Required - Date of the inventory movement. - **bodega_id** (varchar) - Required - Identifier of the warehouse in the system. - **detalles** (array) - Required - Array of product details for the movement. - **producto_id** (varchar) - Required - Identifier of the product in the system. - **precio** (decimal) - Optional - Price of the product in the movement (max 7 integer, 6 decimal). - **cantidad** (decimal) - Optional - Quantity of the product in the movement (max 7 integer, 6 decimal). - **descripcion** (text) - Optional - Description of the movement. - **bodega_destino_id** (varchar) - Optional - Identifier of the destination warehouse in the system (for transfers). - **generar_asiento** (boolean) - Optional - Indicates if the movement should generate an accounting entry. ### Request Example (Income) ```json { "tipo": "ING", "fecha": "01/01/2019", "bodega_id": "ljMEegJAHq0dQ5g3", "detalles": [ { "producto_id": "RYWb4xYKNhz0bZ1m", "precio": "10.0", "cantidad": "1.0" }, { "producto_id": "RYWb4xYKNhz0bZ1m", "precio": "1.0", "cantidad": "15.0" } ], "descripcion": "detalle ingreso" } ``` ### Request Example (Expense) ```json { "tipo": "EGR", "fecha": "08/02/2017", "bodega_id": "lLPEegJAHq0dQty8", "detalles": [ { "producto_id": "2vj6e9pm5Uz3dWBV", "cantidad": "30.0" } ], "descripcion": "detalle egreso" } ``` ### Response #### Success Response (200) - **id** (varchar) - Identifier of the created inventory movement. - **codigo** (varchar) - Code of the created inventory movement. ```