# Turn Bancolombia's Sucursal Virtual Empresas into an API

> Read your reportes de auditoría (audit reports), Saldos consolidados (consolidated balances) and FIC movements from the SVE with one API call each. A workflow can email you the balances each weekday morning and post a weekly record of who did what.

Page: https://fous.com/automate/sucursal-virtual-empresas
Updated: 2026-11-12

Works with your own Sucursal Virtual Empresas account. Fous is an independent product.

## What you can build on the SVE

### Get the audit report

Reads the reportes de auditoría for a date range: every operation done in the SVE, with its transaction type, date, the user who did it and its status.

- Takes: From date, to date (within the last 2 months)
- Returns: Transaction type, date, user, status

### Get consolidated balances

Opens Consultas, then Saldos consolidados, and reads the balance of each of your company's products, accounts and Fondos de Inversión Colectiva (FIC) included.

- Takes: Nothing
- Returns: Product type, product name, product number, balance

### Search movements of a collective fund

Opens one FIC from Saldos consolidados and runs Búsqueda de movimientos (movement search) with the Desde and Hasta dates.

- Takes: Fund number, Desde date, Hasta date
- Returns: Date, description, amount

### Read the request history

Opens Servicio al Cliente, then Solicitudes y Gestión Documental (requests and documents), and reads the histórico de solicitudes with each request's status.

- Takes: Status (optional)
- Returns: Radicado number, request type, created date, status

## Automate the SVE with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Morning balances for treasury

Starts: Every weekday at 7:30, Bogotá time

1. Get the consolidated balances from Saldos consolidados.
2. Mark the products whose balance changed since the last run.
3. Email you the full list, with the changed products first.

### Weekly review of the audit report

Starts: Every Monday at 8:00, Bogotá time

1. Get the audit report for the last 7 days.
2. Summarize the operations by user and transaction type.
3. Post the summary and every operation to your webhook, to keep it after the 2-month window.

### Requests waiting for an approver

Starts: Every weekday at 9:00, Bogotá time

1. Read the request history with the status Pendiente de aprobación.
2. Stop when there are none.
3. Email you each request's radicado number, type and created date.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get the audit report” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "sucursalempresas.transaccionesbancolombia.com/get_audit_report",
    "input": {
      "from": "2026-11-03",
      "to": "2026-11-09"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "company": "Acme S.A.S.",
    "from": "2026-11-03",
    "to": "2026-11-09",
    "operations": [
      {
        "transaction_type": "Pago a proveedores",
        "date": "2026-11-09T10:42:00-05:00",
        "user": "TESORERIA01",
        "status": "Aprobada"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The SVE’s own options

Bancolombia offers its APIs separately from the SVE, through an API portal with a catalog of API products, tested first in a sandbox you request access to, with credentials issued through its help desk. In the SVE you consult statements, balances and movements, pay suppliers and payroll, and download and send your collection files.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Bancolombia APIs (API Market) | A separate catalog of API products, each with its technical documentation, tried first in a sandbox. | A sandbox request naming your company and the API product, approved in under 24 hours on weekdays, and a Client-Id and Client-Secret from the help desk. |
| Payment and collection files in the SVE | Supplier payments and scheduled payroll, and the download and sending of your company's collection files. | Your company's SVE, with users, roles and approvals set up by your administrator. |
| The SVE by hand | Statements, balances and movements, Saldos consolidados, FIC movement search, audit reports and requests, one screen at a time. | Your company's NIT, a user with a password and, for profiles that need it, a token. |

Read on November 12, 2026: [Sucursal Virtual Empresas](https://www.bancolombia.com/negocios/canales/sucursal-virtual-empresas), [Centro de Ayuda APIs Bancolombia](https://soportedevs.bancolombia.com/hc/es-419), [How to request sandbox access](https://soportedevs.bancolombia.com/hc/es-419/articles/12467698138388).

## Signing in to the SVE

The SVE asks for your company's NIT, your user and your password. On an unregistered computer, or when Bancolombia rates the risk as high, it asks you to enrol the computer in Identificación de equipos or answer security questions, and profiles that need one confirm operations with a token. With Fous you sign in through the SVE's own sign-in with your own user, and the login is sealed with AES-256.

## Worth knowing

- **Audit reports reach back 2 months**: The reportes de auditoría show operations from the last 2 months only. To keep a longer record, read them on a schedule and store each run in your own system.
- **FIC movements: 3 months and required dates**: Búsqueda de movimientos covers the current month and the last 3 months. The Desde and Hasta dates are required, so a method takes both as inputs.
- **Control dual decides who finishes a request**: Under control dual, a request from a user who needs approval waits as Pendiente de aprobación until a user with the aprobador role authorizes it. A Superusuario finishes it with the token.
- **Your profile decides which accounts you see**: An account can be missing because it is hidden or your role has no authorized accounts. The account is assigned to a profile in Módulo administrativo, under Perfiles and Administrar perfil.

## More in Finance: corporate banking and credit

- [Banno Business](https://fous.com/automate/banno-business.md)
- [Q2 business online banking](https://fous.com/automate/q2-business-online-banking.md)
- [Absa Access](https://fous.com/automate/absa-access.md)
- [ANZ Transactive - Global](https://fous.com/automate/anz-transactive.md)
- [Axis Corporate Internet Banking](https://fous.com/automate/axis-corporate-internet-banking.md)
- [BancaNet Empresarial](https://fous.com/automate/bancanet-empresarial.md)
- [Banorte en su Empresa](https://fous.com/automate/banorte-en-su-empresa.md)
- [BB Digital PJ](https://fous.com/automate/bb-digital-pj.md)
- [BBVA Net Cash México](https://fous.com/automate/bbva-net-cash-mexico.md)
- [Bradesco Net Empresa](https://fous.com/automate/bradesco-net-empresa.md)
- [businessONLINE](https://fous.com/automate/businessonline.md)
- [CIBC Cash Management Online](https://fous.com/automate/cibc-cash-management-online.md)
- [CommBiz](https://fous.com/automate/commbiz.md)
- [DBS IDEAL](https://fous.com/automate/dbs-ideal.md)
- [FABeAccess](https://fous.com/automate/fabeaccess.md)
- [ICICI Corporate Internet Banking](https://fous.com/automate/icici-corporate-internet-banking.md)
- [Itaú Empresas](https://fous.com/automate/itau-empresas.md)
- [KlikBCA Bisnis](https://fous.com/automate/klikbca-bisnis.md)
- [Kopra by Mandiri](https://fous.com/automate/kopra-by-mandiri.md)
- [Maybank2E](https://fous.com/automate/maybank2e.md)
- [NAB Connect](https://fous.com/automate/nab-connect.md)
- [OCBC Velocity](https://fous.com/automate/ocbc-velocity.md)
- [RBC Express](https://fous.com/automate/rbc-express.md)
- [ScotiaConnect](https://fous.com/automate/scotiaconnect.md)
- [Standard Bank Business Online](https://fous.com/automate/standard-bank-business-online.md)
- [Telecrédito](https://fous.com/automate/telecredito.md)
- [UOB Infinity](https://fous.com/automate/uob-infinity.md)
- [Westpac Corporate Online](https://fous.com/automate/westpac-corporate-online.md)
- [YONO Business](https://fous.com/automate/yono-business.md)
- [Interbanking](https://fous.com/automate/interbanking.md)
- [PINACLE](https://fous.com/automate/pinacle.md)
- [SinglePoint](https://fous.com/automate/singlepoint.md)
- [Wells Fargo Vantage](https://fous.com/automate/wells-fargo-vantage.md)

Other industries: [Worldpay iQ](/automate/worldpay-iq), [eMPF Platform](/automate/empf-platform), [Income Tax e-Filing Portal](/automate/income-tax-e-filing-portal), [Trip.com eBooking](/automate/trip-com-ebooking), [SRI en Línea](/automate/sri-en-linea), [Egyptian Tax Authority e-Services](/automate/egyptian-tax-authority-e-services).

## Frequently asked questions

### Does Sucursal Virtual Empresas have an API?

Not as part of the SVE. Bancolombia offers its APIs separately, through an API portal with a catalog of API products. You request sandbox access with your company name and the product, approval takes under 24 hours on weekdays, and the help desk issues a Client-Id and Client-Secret.

### How far back do the SVE audit reports go?

Two months. The reportes de auditoría show every operation from that period with its transaction type, date, the user who did it and its status. A scheduled workflow can read them every week and post them to your own system before they drop out.

### Why can't I see the account I want to pay from?

The account may be hidden, your role may have no authorized accounts, or the account is not registered in the channel. A principal user registers it and assigns it to the profile in Módulo administrativo, Perfiles, Administrar perfil, confirmed with a token or by the aprobador.

### Can I keep my SVE token for Sucursal Virtual Negocios?

Yes. Bancolombia says you can keep the same token, and reassign it to Sucursal Virtual Negocios when you start using that channel, under Administración del canal, Protege tu canal and Administrar Token.

### Is Fous affiliated with Bancolombia?

No. Fous is an independent product. You use it with your own Sucursal Virtual Empresas user, and a method reads and does only what that user's profile can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Sucursal Virtual Empresas (Bancolombia). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.