Saltar al contenido principal

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 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.
Treat these credentials as sensitive information. Do not share them in open channels or expose them in public code.
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: 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.
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.
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.
Align each property with the node JSON; do not assume field names before reviewing them in Brain Studio.
Example (indicative):
{
  "customer_id": "12345",
  "items": [
    {
      "code": "SKU-001",
      "quantity": 2,
      "unit_price": 25.5
    }
  ]
}
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):
{
  "customer_id": "12345",
  "items": [
    {
      "code": "SERV-CONSULTA",
      "quantity": 1,
      "unit_price": 150
    }
  ]
}
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:
{
  "start_date": "2025-01-01",
  "end_date": "2025-01-31"
}
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:
{
  "customer_id": "12345"
}
Validate in the node the exact customer field name (customer_id or another one).
Queries available stock for a product in a specific warehouse.Inputs:
  • product and warehouse identifiers (or equivalent values) required by the tool.
Example:
{
  "product_id": "SKU-001",
  "warehouse_id": "BOD-QUITO"
}
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:
{
  "document_id": "FAC-001-123"
}
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:
{
  "identification": "1712345678"
}
If the node shows two different filters, send at least one; do not leave the body empty if the tool marks it as invalid.
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:
{
  "code": "SKU-001"
}
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):
{
  "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.
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.
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. 
{
  "customer_id": "{{$memory.cliente_id}}",
  "items": [
    {
      "code": "{{$memory.codigo_producto}}",
      "quantity": "{{$memory.cantidad}}",
      "unit_price": "{{$memory.precio_unitario}}"
    }
  ]
}

​
Use cases

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
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
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
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

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
Useful for logging sales, payments, or report results into an operational sheet for administrative follow-up or internal analysis.Google Sheets documentation
A strong combination when you need to link the issued document or customer status with CRM commercial context.HubSpot documentation
Lets you notify the team when an invoice is issued, a payment is recorded, or a status appears that requires human review.Slack documentation

Integrations

Catalog of integrations available in Marketplace.

How to use integrations in Brain

General flow to install and use integrations in Brain Studio.