find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/btg-pactual:btg-pactual-operaciones-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: SCF - Colombia Operaciones API
  description: API para consultar límites y gestionar operaciones de Supply Chain Finance en Colombia.
  version: '1'
servers:
- url: https://api.uat.empresas.btgpactual.com/v1/scf
  description: UAT
- url: https://api.empresas.btgpactual.com/v1/scf
  description: Producción
tags:
- name: Operaciones
paths:
  /borderos/{trackingId}/receivables/cancel:
    post:
      tags:
      - Operaciones
      description: Cancelar facturas de una operación
      operationId: cancelColombiaBorderoReceivables
      parameters:
      - name: trackingId
        in: path
        required: true
        description: Identificador de seguimiento de la operación.
        schema:
          type: string
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - Receivables
              properties:
                Receivables:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                    - Identification
                    - MaturityDate
                    - MaturityAmount
                    properties:
                      Identification:
                        type: string
                      MaturityDate:
                        type: string
                        format: date-time
                      MaturityAmount:
                        type: number
                        format: double
              title: CancelReceivablesRequest
      responses:
        '200':
          description: Solicitud de cancelación recibida correctamente.
        '400':
          description: Solicitud inválida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: string
                  Message:
                    type: string
                title: ErrorResponse
        '404':
          description: Recurso no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: string
                  Message:
                    type: string
                title: ErrorResponse
      security:
      - write:
        - empresas.btgpactual.com/scf/borderos
      x-docs-url: https://developers.empresas.btgpactual.com/docs/api-specs-target/SCF%20-%20Colombia/cancel-colombia-bordero-receivables
      summary: Cancel colombia bordero receivables
      x-summary-source: derived
  /borderos:
    post:
      tags:
      - Operaciones
      description: Crea una operación con sus facturas en Colombia.
      operationId: createColombiaBordero
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - Receivables
              - Product
              properties:
                PayerTaxId:
                  type:
                  - string
                  - 'null'
                  description: NIT del pagador aplicable a todos los documentos por cobrar.
                PayerCountryCode:
                  type:
                  - string
                  - 'null'
                  description: Código ISO 3166-1 alpha-2 del país del pagador.
                  example: CO
                Receivables:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                    - PayerTaxId
                    - PayeeTaxId
                    - Identification
                    - MaturityDate
                    - MaturityAmount
                    - DocumentType
                    - Currency
                    - RadianEvent
                    properties:
                      PayerTaxId:
                        type: string
                        description: NIT del pagador.
                        example: '900000001'
                      PayerCountryCode:
                        type: string
                        enum:
                        - CO
                        description: Código ISO 3166-1 alpha-2 del país del pagador.
                      PayeeTaxId:
                        type: string
                        description: NIT del proveedor.
                        example: '900000002'
                      PayeeName:
                        type: string
                        description: Razón social del proveedor.
                      PayeeCountryCode:
                        type: string
                        enum:
                        - CO
                        description: Código ISO 3166-1 alpha-2 del país del proveedor.
                      Identification:
                        type: string
                        description: Identificador único del documento por cobrar.
                      MaturityDate:
                        type: string
                        format: date-time
                        description: Fecha de vencimiento.
                      MaturityAmount:
                        type: number
                        format: double
                        description: Valor nominal al vencimiento.
                      DisbursementAmount:
                        type:
                        - number
                        - 'null'
                        format: double
                        description: Valor previsto para el desembolso.
                      DisbursementDate:
                        type:
                        - string
                        - 'null'
                        format: date-time
                        description: Fecha prevista para el desembolso.
                      DocumentType:
                        type: string
                        enum:
                        - Offshore
                        description: Tipo de documento utilizado en la operación.
                      Currency:
                        type: string
                        enum:
                        - COP
                        description: Moneda de la operación.
                      OriginId:
                        type:
                        - string
                        - 'null'
                        description: Identificador del documento en el sistema de origen.
                      InvoiceKey:
                        type:
                        - string
                        - 'null'
                        description: CUFE de la factura electrónica.
                      SubProduct:
                        type:
                        - string
                        - 'null'
                        enum:
                        - Confirming
                        - Factoring
                        description: Modalidad de la operación.
                      LegitimateHolderTaxId:
                        type:
                        - string
                        - 'null'
                        description: NIT del legítimo tenedor.
                      LegitimateHolderName:
                        type:
                        - string
                        - 'null'
                        description: Razón social del legítimo tenedor.
                      Account:
                        type:
                        - object
                        - 'null'
                        allOf:
                        - type: object
                          properties:
                            Bank:
                              type:
                              - string
                              - 'null'
                              description: Código del banco.
                            Agency:
                              type:
                              - string
                              - 'null'
                              description: Código de la sucursal.
                            AgencyDigit:
                              type:
                              - string
                              - 'null'
                              description: Dígito de la sucursal.
                            Number:
                              type:
                              - string
                              - 'null'
                              description: Número de la cuenta.
                            Digit:
                              type:
                              - string
                              - 'null'
                              description: Dígito de la cuenta.
                            Type:
                              type:
                              - string
                              - 'null'
                              description: Tipo de cuenta, por ejemplo Ahorros o Corriente.
                            OwnerTaxId:
                              type:
                              - string
                              - 'null'
                              description: NIT del titular de la cuenta.
                            OwnerName:
                              type:
                              - string
                              - 'null'
                              description: Razón social del titular de la cuenta.
                            Company:
                              type:
                              - string
                              - 'null'
                              description: Identificador de la empresa asociada.
                            Cge:
                              type:
                              - string
                              - 'null'
                              description: Identificador CGE.
                          title: ColombiaAccount
                      IssueDate:
                        type:
                        - string
                        - 'null'
                        format: date-time
                        description: Fecha de emisión de la factura.
                      RadianEvent:
                        type: string
                        description: Código obligatorio del evento RADIAN.
                        example: '037'
                      DiscountDate:
                        type:
                        - string
                        - 'null'
                        format: date-time
                        description: Fecha de descuento.
                    title: ColombiaReceivable
                Strategy:
                  type:
                  - string
                  - 'null'
                  format: uuid
                  description: Identificador de la estrategia comercial. Campo opcional.
                Product:
                  type: string
                  enum:
                  - CSCSacado
                  description: Producto de la operación. Debe informarse como CSCSacado.
                TrackingId:
                  type:
                  - string
                  - 'null'
                  format: uuid
                  description: Identificador de seguimiento proporcionado por el cliente. Campo opcional.
                PartnerIdentification:
                  type:
                  - string
                  - 'null'
                  description: Identificación del partner que origina la operación.
              title: CreateBorderoRequest
            example:
              PayerTaxId: null
              PayerCountryCode: null
              Receivables:
              - PayerTaxId: '900000001'
                PayerCountryCode: CO
                PayeeTaxId: '900000002'
                PayeeName: PROVEEDOR DE EJEMPLO SAS
                PayeeCountryCode: CO
                Identification: FE-2669
                MaturityDate: '2026-09-11T00:00:00-03:00'
                MaturityAmount: 752256558
                DisbursementAmount: 742640140.34779
                DisbursementDate: '2026-08-14T00:00:00-03:00'
                DocumentType: Offshore
                Currency: COP
                OriginId: 2b3fe241-2dc3-4a04-a0f0-342b1872861d
                InvoiceKey: CUFE-1234567890
                SubProduct: Confirming
                LegitimateHolderTaxId: '900000003'
                LegitimateHolderName: TENEDOR LEGÍTIMO DE EJEMPLO SAS
                Account:
                  Bank: '1007'
                  Agency: '999'
                  AgencyDigit: null
                  Number: '0000000000'
                  Digit: null
                  Type: Ahorros
                  OwnerTaxId: '900000003'
                  OwnerName: TENEDOR LEGÍTIMO DE EJEMPLO SAS
                  Company: null
                  Cge: null
                IssueDate: '2026-08-05T00:00:00-03:00'
                RadianEvent: '037'
                DiscountDate: '2026-08-14T00:00:00-03:00'
              Strategy: ba00e42d-1a7f-470e-b9c5-cae2d82ec435
              Product: CSCSacado
              TrackingId: 64166ec5-0d73-4050-9e2f-244f674ce86f
              PartnerIdentification: null
      responses:
        '201':
          description: Operación creada correctamente.
          headers:
            Location:
              description: Dirección para consultar la operación creada.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                - TrackingId
                properties:
                  TrackingId:
                    type: string
                    format: uuid
                    description: Identificador de seguimiento de la operación creada.
                title: CreateBorderoResponse
        '400':
          description: Solicitud inválida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: string
                  Message:
                    type: string
                title: ErrorResponse
      security:
      - write:
        - empresas.btgpactual.com/scf/borderos
      x-docs-url: https://developers.empresas.btgpactual.com/docs/api-specs-target/SCF%20-%20Colombia/create-colombia-bordero
      summary: Create colombia bordero
      x-summary-source: derived
  /borderos/{trackingId}/receivables:
    get:
      tags:
      - Operaciones
      description: Consultar las facturas de una operación
      operationId: getColombiaBorderoReceivables
      parameters:
      - name: trackingId
        in: path
        required: true
        description: Identificador de seguimiento de la operación.
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Facturas consultadas correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  TrackingId:
                    type: string
                    format: uuid
                  CreatedAt:
                    type: string
                    format: date-time
                  Receivables:
                    type: array
                    items:
                      type: object
                      properties:
                        Identification:
                          type: string
                        Status:
                          type: string
                title: BorderoResponse
        '404':
          description: Recurso no encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Code:
                    type: string
                  Message:
                    type: string
                title: ErrorResponse
      security:
      - write:
        - empresas.btgpactual.com/scf/borderos
      - read:
        - empresas.btgpactual.com/scf/borderos.readonly
      x-docs-url: https://developers.empresas.btgpactual.com/docs/api-specs-target/SCF%20-%20Colombia/get-colombia-bordero-receivables
      summary: Get colombia bordero receivables
      x-summary-source: derived
components:
  securitySchemes:
    write:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://id.btgpactual.com/oauth2/token
          scopes:
            empresas.btgpactual.com/scf/borderos: Crear y cancelar operaciones.
    read:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://id.btgpactual.com/oauth2/token
          scopes:
            empresas.btgpactual.com/scf/borderos.readonly: Consultar operaciones.
            empresas.btgpactual.com/scf/companies.readonly: Consultar límites de empresas.
x-reassembled-from:
  source: https://developers.empresas.btgpactual.com/docs/api-specs-target/
  method: Operation objects decoded verbatim from the "api" payload that the provider's Docusaurus OpenAPI docs embed in each reference page chunk (/assets/js/*.js); grouped by info.title; jsonRequestBodyExample and postman keys dropped.
  chunks:
  - https://developers.empresas.btgpactual.com/assets/js/fbd0b353.31d1d2ce.js
  - https://developers.empresas.btgpactual.com/assets/js/08c77af0.814da34c.js
  - https://developers.empresas.btgpactual.com/assets/js/67203ac0.4a8ffdda.js
  - https://developers.empresas.btgpactual.com/assets/js/14f9e484.52c9d025.js