> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Contífico

> Issue invoices and proformas, check inventory, list customers and products, and record Contífico payments from Brain Studio.

**Contífico** is a cloud-based electronic invoicing and accounting system focused on **Ecuador**. In **Brain Studio**, this integration allows your flows and agents to **create invoices and proformas**, **generate sales reports**, **query document history and status**, **check warehouse-level inventory**, **search registered customers and products**, and **record payments** on existing documents, based on available tools.

## What Contífico enables

When you connect **Contífico**, you can:

* **Issue** electronic invoices and **proformas**, with **number**, **status**, and **PDF** when included in the response
* **Generate** sales reports within a **date range**
* **Query** customer invoice history, **document status**, **stock by product and warehouse**, and **customer** and **product** catalogs
* **Record payments** on **existing documents** in Contífico

***

## Installation

### Prerequisites

1. An **active Contífico account** with electronic invoicing configured according to Ecuador regulations.
2. An accounting system plan with **API enabled**. API access is available starting from **Sistema Contable Plus**.
3. Credentials provided by **Siigo Contífico** for integration: **Api Key** and **POS Api Token**.

### How to get credentials

To connect **Contífico** in Brain Studio, you need two credentials provided by **Siigo Contífico**:

* **Api Key**
* **POS Api Token**

**1. Request credentials from support or customer service**

In **Contífico**, the **Api Key** and **POS Api Token** are not generated through self-service in the panel. You must request them from the **support or customer service** team at **Siigo Contífico** for your company.

**2. Receive Api Key and POS Api Token**

Once API access is enabled for your account, the **Siigo Contífico** team will share the credentials required for integration.

> [!WARNING]
>
> Treat these credentials as sensitive information. Do not share them in open channels or expose them in public code.

> [!TIP]
>
> To install the integration in Brain Studio, you need exactly these two values: **Api Key** and **POS Api Token**.

### How to connect it

The most direct way is to use [**Jelou Agent**](https://docs.jelou.ai/en/guides/getting-started/jelou-agent.md): describe what you need and the agent connects **Contífico** automatically inside the flow.

If you prefer manual setup, open **Marketplace** and follow these steps with the credentials obtained in the previous step.

**1. Open Marketplace**

In Brain Studio, open **Marketplace** from the side menu.

**2. Find Contífico**

Locate the integration and click **Connect**.

**3. Enter credentials**

Complete the form with your **Api Key** and **POS Api Token**.

**4. Confirm installation**

The integration appears as **connected**.

> [!TIP]
>
> You can use it in **Canvas** or add it as a tool in **AI Agent**.

***

## Available tools

At a high level, actions are grouped as follows:

* **Issue documents** - **Create invoice** and **Create proforma invoice** (same base fields).
* **Information and reports** - **Generate sales report**, **Get customer history**, **Get invoice status**, and **Get inventory status**.
* **Catalog** - **List Customers** and **List Products** (each requires **at least one** of the two filters defined by the tool in the node).
* **Collections** - **Record payment** on an existing document.

The integration exposes **9 tools** in Brain Studio; below, each one includes purpose, indicative inputs, and an example. Exact field names must match the **node editor** and what the Contífico API accepts.

> [accordion] Create invoice
>
> Generates an electronic invoice in Contífico. Returns invoice **number**, **status**, and **PDF link** according to platform response.
>
> **Inputs:**
>
> * Invoice structure required by Contífico: customer identification, line items (product or service, quantities, prices, taxes if applicable), dates, payment method, and any other required fields shown in the form.
>
> > [!NOTE]
> >
> > Align each property with the node JSON; do not assume field names before reviewing them in Brain Studio.
>
> **Example (indicative):**
>
> ```json theme={null}
> {
>   "customer_id": "12345",
>   "items": [
>     {
>       "code": "SKU-001",
>       "quantity": 2,
>       "unit_price": 25.5
>     }
>   ]
> }
> ```

> [accordion] Create proforma invoice
>
> Generates a **proforma** (pre-invoice or quote) with the **same fields** as an invoice in this integration.
>
> **Inputs:**
>
> * Same criteria as **Create invoice**: complete the body based on the schema shown in the node editor.
>
> **Example (indicative):**
>
> ```json theme={null}
> {
>   "customer_id": "12345",
>   "items": [
>     {
>       "code": "SERV-CONSULTA",
>       "quantity": 1,
>       "unit_price": 150
>     }
>   ]
> }
> ```

> [accordion] Generate sales report
>
> Generates a sales summary (invoices) in the specified **date range**.
>
> **Inputs:**
>
> * Start and end date limits (plus any aggregation or filtering parameter exposed by the node).
>
> **Example:**
>
> ```json theme={null}
> {
>   "start_date": "2025-01-01",
>   "end_date": "2025-01-31"
> }
> ```

> [accordion] Get customer history
>
> Returns invoices associated with a customer in Contífico. This tool **returns only translated text**, without additional explanations in the response body.
>
> **Inputs:**
>
> * Customer identifier or criteria and, if applicable, date range or other filters according to the form.
>
> **Example:**
>
> ```json theme={null}
> {
>   "customer_id": "12345"
> }
> ```
>
> > [!NOTE]
> >
> > Validate in the node the exact customer field name (**customer\_id** or another one).

> [accordion] Get inventory status
>
> Queries available stock for a **product** in a specific **warehouse**.
>
> **Inputs:**
>
> * **product** and **warehouse** identifiers (or equivalent values) required by the tool.
>
> **Example:**
>
> ```json theme={null}
> {
>   "product_id": "SKU-001",
>   "warehouse_id": "BOD-QUITO"
> }
> ```

> [accordion] Get invoice status
>
> Queries the status of an invoice or other document in Contífico.
>
> **Inputs:**
>
> * Document reference (number, internal ID, or URI, depending on node definition).
>
> **Example:**
>
> ```json theme={null}
> {
>   "document_id": "FAC-001-123"
> }
> ```

> [accordion] List Customers
>
> Searches customers registered in the Contífico account. **Requires at least one** of the **two filters** defined by the tool in Brain Studio.
>
> **Inputs:**
>
> * Two optional filters with a minimum-one rule; exact names appear in the editor (for example identification, name, email, etc.).
>
> **Example:**
>
> ```json theme={null}
> {
>   "identification": "1712345678"
> }
> ```
>
> > [!NOTE]
> >
> > If the node shows two different filters, send at least one; do not leave the body empty if the tool marks it as invalid.

> [accordion] List Products
>
> Searches products or services registered in Contífico. **Requires at least one** of the **two filters** defined by the tool.
>
> **Inputs:**
>
> * Same logic as **List Customers**: review the two available filters and send at least one.
>
> **Example:**
>
> ```json theme={null}
> {
>   "code": "SKU-001"
> }
> ```

> [accordion] Record payment
>
> Records a payment for an existing document in Contífico (for example, a pending invoice).
>
> **Inputs:**
>
> * Document reference, **amount**, payment **date**, **method**, and any additional required field in the form.
>
> **Example (indicative):**
>
> ```json theme={null}
> {
>   "document_id": "FAC-001-123",
>   "amount": 150.75,
>   "payment_date": "2025-02-15",
>   "payment_method": "transfer"
> }
> ```

***

## How to use in Brain

Once connected, you can use **Contífico** on two surfaces:

### In AI Agent

Ideal when the user wants to **issue** an invoice or proforma, **query** document or inventory status, **list** customers or products to disambiguate, or **record a payment**, in natural language.

**1. Open the AI Agent node**

In Canvas, select or add the **AI Agent** node.

**2. Open Tools**

In the right panel, go to the **Tools** tab.

**3. Add Contífico**

Use **Add tool**, search for **Contífico**, and enable it.

**4. Configure tools**

Choose full integration or enable only the actions you need.

> [!TIP]
>
> **Contífico** appears in the agent tools list, and you can open settings from the integration icon.

The agent can chain, for example, **List Customers** or **List Products** before **Create invoice**, or **Get invoice status** before **Record payment**, depending on the conversation.

### In Canvas

Ideal when you need a fixed order (for example: list customer -> create invoice -> record payment -> notify through another channel).

**1. Drag Contífico into Canvas**

In the side panel, open **Marketplace** and drag **Contífico** into the flow.

**2. Select the tool**

With the node selected, in **Tools** choose the action (for example **Create invoice** or **Generate sales report**).

**3. Configure body and memory**

Fill out the JSON request body and, if needed, **Save response** in a memory variable.

**4. Connect the flow**

Link **Task completed** and **There was an error** outputs to the next nodes.

> [!TIP]
>
> The node is ready to run in the order defined by your flow.

**Configuration example:**

The node editor shows the expected body for each tool. For **Create invoice**, it usually includes customer and lines; replace values with memory variables when data comes from previous steps.

```json theme={null}
{
  "customer_id": "{{$memory.cliente_id}}",
  "items": [
    {
      "code": "{{$memory.codigo_producto}}",
      "quantity": "{{$memory.cantidad}}",
      "unit_price": "{{$memory.precio_unitario}}"
    }
  ]
}
```

***

## Use cases

> [accordion] Issue invoice or proforma from a conversation
>
> The flow takes data already captured in the conversational channel and generates the document in **Contífico** without the team entering the system.
>
> **Typical flow:**
>
> * User confirms sale or requests a quote
> * Flow identifies customer with **List Customers**
> * It validates product or service with **List Products**
> * It creates the document with **Create invoice** or **Create proforma invoice**
> * It returns number, status, and PDF if included in the response
>
> **Impact:**
>
> * Less manual operational work
> * Faster issuance from the same channel where sale happens
> * Better continuity between conversation and invoicing
>
> **Ideal for:** chat-assisted sales, WhatsApp channels, and commercial teams in Ecuador

> [accordion] Record payment on an existing invoice
>
> The flow confirms a payment and records it in **Contífico** on the correct document.
>
> **Typical flow:**
>
> * User or operator reports payment has been made
> * Flow checks the document with **Get invoice status**
> * It records collection with **Record payment**
> * It returns confirmation to continue the process or notify the customer
>
> **Impact:**
>
> * Less lag between reported payments and accounting system
> * Better operational control of receivables
> * Fewer reprocessing tasks for the administrative team
>
> **Ideal for:** collections, payment follow-up, and administrative operations

> [accordion] Query document history and status
>
> The agent answers frequent questions about issued invoices without escalating every case to finance.
>
> **Typical flow:**
>
> * User asks about an invoice or their history
> * Flow uses **Get customer history** to return associated invoices
> * It uses **Get invoice status** when validating a specific document
> * It summarizes information in the conversation
>
> **Impact:**
>
> * Fewer manual queries to the administrative area
> * Faster responses for customers and internal teams
> * Better self-service on issued documents
>
> **Ideal for:** B2B customer service, administrative support, and post-sales follow-up

> [accordion] Validate stock or review sales before acting
>
> The flow queries operational data in **Contífico** before committing to a sale, a delivery, or a commercial decision.
>
> **Typical flow:**
>
> * Agent looks up product with **List Products**
> * It checks warehouse stock with **Get inventory status**
> * Or it generates commercial summary with **Generate sales report**
> * It uses that information to answer or trigger the next flow step
>
> **Impact:**
>
> * Better informed real-time decisions
> * Fewer errors from promising unavailable stock
> * Fast commercial performance visibility without manual exports
>
> **Ideal for:** operations, sales, and internal control

***

## Integrations that pair well with Contífico

> [accordion] Gmail
>
> Useful for sending customers the **PDF** of an invoice or proforma, or sharing by email details of a document generated from the flow.
>
> [Gmail documentation](https://docs.jelou.ai/en/guides/integraciones/productividad/gmail)

> [accordion] Google Sheets
>
> Useful for logging sales, payments, or report results into an operational sheet for administrative follow-up or internal analysis.
>
> [Google Sheets documentation](https://docs.jelou.ai/en/guides/integraciones/productividad/google-sheets)

> [accordion] HubSpot
>
> A strong combination when you need to link the issued document or customer status with CRM commercial context.
>
> [HubSpot documentation](https://docs.jelou.ai/en/guides/integraciones/crm/hubspot)

> [accordion] Slack
>
> Lets you notify the team when an invoice is issued, a payment is recorded, or a status appears that requires human review.
>
> [Slack documentation](https://docs.jelou.ai/en/guides/integraciones/productividad/slack)

***

## Related articles

> [card] [Integrations](https://docs.jelou.ai/en/guides/integrations/integrations.md)
>
> Catalog of integrations available in Marketplace.

> [card] [How to use integrations in Brain](https://docs.jelou.ai/en/guides/integrations/how-to-use-integrations-in-brain.md)
>
> General flow to install and use integrations in Brain Studio.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.