Ficha técnica

La API SCF - Colombia permite consultar el límite de un pagador y registrar documentos por cobrar para operaciones de Confirming y Factoring en Colombia.

Seguridad

📘 BTG Id

El Authorization Server de BTG Empresas se llama BTG Id. La API utiliza el flujo Client Credentials. Consulte la documentación de autenticación.

Scopes necesarios

Scope	Descripción
empresas.btgpactual.com/scf/borderos	Permite crear y cancelar operaciones.
empresas.btgpactual.com/scf/borderos.readonly	Permite consultar operaciones.
empresas.btgpactual.com/scf/companies.readonly	Permite consultar el límite del pagador.

Recursos disponibles

Método	Recurso	Descripción
GET	/v1/scf/companies/limit/{payerTaxId}	Consulta el límite total y disponible del pagador.
POST	/v1/scf/borderos	Crea una operación para Colombia.
GET	/v1/scf/borderos/{trackingId}/receivables	Consulta las facturas de una operación.
POST	/v1/scf/borderos/{trackingId}/receivables/cancel	Cancela las facturas de una operación.

Reglas para Colombia

• Product es obligatorio y debe enviarse con el valor CSCSacado.
• RadianEvent es obligatorio para cada documento por cobrar.
• Strategy y TrackingId son opcionales.
• SubProduct acepta los valores Confirming y Factoring.
• El CUFE de la factura electrónica debe enviarse en InvoiceKey.
• LegitimateHolderTaxId representa el NIT del legítimo tenedor.
• LegitimateHolderName representa la razón social del legítimo tenedor.

Ejemplo de creación de una operación

{
  "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.0,
      "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
}

Ejemplo de respuesta de límite

{
  "MaxLimit": 1000000000,
  "AvailableLimit": 750000000
}

Eventos de webhook

Los siguientes payloads representan el contenido del campo data.

Evento	Descripción
receivables.calculated-fees	Curva de tasas publicada o actualizada.
receivables.changed-status	Estado de un documento por cobrar actualizado.

receivables.calculated-fees

{
  "taxIds": [
    "900000001"
  ],
  "product": "CSCSacado",
  "strategyId": "72e4d0db-841c-4bcd-9750-98e333507f67",
  "strategyName": "Estrategia predeterminada",
  "currency": "COP",
  "feesCurve": [
    {
      "baseDate": "2026-08-12",
      "settlementDate": "2026-09-12",
      "monthlyFee": 0.0125,
      "totalFee": 0.0125
    }
  ]
}

receivables.changed-status

{
  "id": 0,
  "identification": "FE-2669",
  "trades": [
    {
      "id": "string",
      "contractNumber": "123-12345",
      "disbursedAmount": 0,
      "disbursementDate": "2026-08-21"
    }
  ],
  "maturityDate": "2026-08-21",
  "status": "Aprovado",
  "payeeTaxId": "900000002",
  "payerTaxId": "900000001",
  "borderoTrackingId": "3382cc6f-1c59-4423-b364-c837deaf110d",
  "motivos": ["string"],
  "invoiceIdentification": "FE-2669",
  "nettedPaymentIdentification": "string",
  "eventTimestamp": "2026-08-21T18:41:33.159Z"
}