Migrar a los nombres en inglés

Desde la versión 2026-11-03 todos los identificadores de la API están en inglés: rutas, campos, valores y códigos de error. Los textos para personas (message) siguen en español.

Si tu cuenta existía antes de esa fecha, sigue en 2026-10-22 (los nombres de siempre) hasta el 1 de febrero de 2027 (2027-02-01): nada se rompe hoy. Ese día los nombres en español dejan de existir. Producción arranca sólo en inglés, así que conviene pasarse antes de salir.

Tu agente también tiene esta guía: el MCP de Bolívar Connect la sirve entera con la herramienta bc_docs (slug guias/migrar-a-ingles, language: es).

Lo que no cambia

Si dispersas con cotización, beneficiario y pago, casi todo sigue igual:

POST /v1/quotes, POST /v1/payouts, /v1/beneficiaries, /v1/payments, /v1/events, GET /v1/limits/usage y GET /v1/treasury/position, con sus campos.
pago_movil y transferencia en method: son los nombres de los métodos de pago venezolanos y no se traducen.
Los webhooks payment.settled, payment.failed y payment.reversed, su payload y su firma.
Idempotency-Key, la paginación y los demás error.code que ya estaban en inglés (limit_exceeded, insufficient_tenant_funds, quote_expired…).
Tus API keys, tus scopes y la URL y el secreto de tu webhook.
Por ahora, el prefondeo (/v1/prefondeos), las gift cards (/v1/giftcards/catalogo, /v1/giftcards/programa y el status de una gift card) y los cobros BDV (/v1/bancos/bdv/*) conservan sus nombres en las dos versiones. Pasan a inglés más adelante, con el mismo mecanismo y su propia ventana; esta guía los listará entonces.

Lo que cambia

Rutas

Antes (`2026-10-22`)	Ahora (`2026-11-03`)
`GET /v1/payments/metricas`	`GET /v1/payments/metrics`
`POST,GET /v1/treasury/tasa-venta`	`/v1/treasury/sell-rate`
`GET /v1/treasury/volumen`	`GET /v1/treasury/volume`
`GET,POST /v1/treasury/fee-volumen`	`/v1/treasury/volume-fee`
`POST,GET /v1/treasury/fondeos`	`/v1/treasury/fundings`
`POST /v1/treasury/custodia`	`POST /v1/treasury/custody`
`GET /v1/treasury/inventario`	`GET /v1/treasury/inventory`
`POST /v1/treasury/cuadre`	`POST /v1/treasury/daily-close`
`GET /v1/treasury/cuadres`	`GET /v1/treasury/daily-closes`
`GET /v1/tenant/capacidades`	`GET /v1/tenant/capabilities`
`GET /v1/tenant/conexiones-mcp`	`GET /v1/tenant/mcp-connections`
`DELETE /v1/tenant/conexiones-mcp/{id}`	`DELETE /v1/tenant/mcp-connections/{id}`
`POST /v1/pruebas/sembrar`	`POST /v1/test-helpers/seed`
`POST /v1/pruebas/fondeos`	`POST /v1/test-helpers/fundings`
`POST /v1/pruebas/pagos/{id}/resolver`	`POST /v1/test-helpers/payments/{id}/resolve`
`POST /v1/pruebas/prefondeos/{id}/cargar`	`POST /v1/test-helpers/prefunds/{id}/credit`
`POST /v1/pruebas/prefondeos/wallets-origen/{id}/activar`	`POST /v1/test-helpers/prefunds/source-wallets/{id}/activate`
(nueva)	`PUT /v1/tenant/api-version`

Campos (petición, respuesta y query)

Cada fila es un campo. La regla vale dondequiera que aparezca en esas rutas, también dentro de objetos anidados y en la query (?desde=&hasta= → ?from=&to=, ?estado= → ?status=).

Antes	Ahora	Dónde
`nombre`	`name`	Cuenta, capacidades
`entorno`	`environment`	`GET /v1/tenant/me`, capacidades
`modo`	`mode`	Capacidades
`fondeo`	`funding`	Capacidades
`modelo`	`model`	Capacidades (`funding.model`), `POST /v1/test-helpers/seed`
`limiteCredito`	`creditLimit`	`funding`
`dondeVerSaldo`	`balanceEndpoint`	`funding`
`dispersion`	`payouts`	Capacidades
`metodos`	`methods`	`payouts`
`metodo`	`method`	`limits[]`, ayudas de prueba
`activo`	`asset`	`payouts`, `limits[]`, tasa de venta, volumen
`limites`	`limits`	Capacidades
`alcance`	`scope`	`limits[]`
`porOperacion`	`perTransaction`	`limits[]`
`porDia`	`perDay`	`limits[]`
`porMes`	`perMonth`	`limits[]`
`operacionesPorDia`	`transactionsPerDay`	`limits[]`
`configurado`	`configured`	`webhook` en capacidades
`ultimaEntrega`	`lastDeliveryAt`	`webhook` en capacidades
`eventosMuertos`	`deadEvents`	`webhook` en capacidades
`tasaVenta`	`sellRates`	Capacidades
`tasaVenta`	`sellRate`	`POST /v1/test-helpers/seed`
`tasa`	`rate`	Tasa de venta (petición y respuesta), líneas del volumen
`fijadaPor`	`setBy`	Tasa de venta
`fijadaEn`	`setAt`	Tasa de venta
`deHoy`	`isToday`	Tasa de venta
`fijadoPor`	`setBy`	Fee por volumen
`vigenteDesde`	`effectiveFrom`	Fee por volumen
`vigente_desde`	`effective_from`	Historial del fee por volumen
`fee_volumen_bps`	`volume_fee_bps`	Historial del fee por volumen
`feeVolumenBps`	`volumeFeeBps`	Volumen, posición del fondeo de pruebas
`estado`	`status`	Fondeos, cuadres, conexiones MCP (también `?estado=`)
`montoUsd`	`amountUsd`	Fondeos
`montoBs`	`amountBs`	Fondeos
`tasaPromedio`	`averageRate`	Fondeos, inventario, posición
`referencia`	`reference`	Fondeos
`comprobante`	`receipt`	Fondeos
`nota`	`note`	Fondeos
`registradoPor`	`recordedBy`	Fondeos
`aprobadoPor`	`approvedBy`	Fondeos
`resueltoEn`	`resolvedAt`	Fondeos
`motivoRechazo`	`rejectionReason`	Fondeos
`creadoEn`	`createdAt`	Fondeos
`posicion`	`position`	Fondeo de pruebas
`saldoBs`	`balanceBs`	Inventario, posición
`costoUsd`	`costUsd`	Inventario, posición
`desde`	`from`	Volumen (campo y query)
`hasta`	`to`	Volumen (campo y query)
`zonaHoraria`	`timeZone`	Volumen, métricas de pagos
`pagos`	`paymentCount`	Volumen
`devoluciones`	`returnCount`	Volumen
`volumenBs`	`volumeBs`	Volumen
`volumenUsd`	`volumeUsd`	Volumen
`pagosSinValorUsd`	`paymentsWithoutUsdValue`	Volumen
`tramos`	`tiers`	Volumen
`comisionRedBs`	`networkFeeBs`	Volumen
`comisionRedUsd`	`networkFeeUsd`	Volumen
`detalle`	`lines`	Volumen
`tipo`	`type`	Líneas del volumen
`fecha`	`date`	Líneas del volumen, métricas de pagos
`saldoReal`	`actualBalance`	Cuadre
`saldoEsperado`	`expectedBalance`	Cuadre
`diferencia`	`difference`	Cuadre
`origen`	`source`	Cuadre
`detalle`	`detail`	Cuadre
`cantidad`	`count`	Métricas de pagos
`monto`	`amount`	Métricas de pagos
`porEstado`	`byStatus`	Métricas de pagos
`tasaExito`	`successRate`	Métricas de pagos
`medianaSegundosHastaSettled`	`medianSecondsToSettled`	Métricas de pagos
`entregado`	`delivered`	`POST /v1/tenant/webhook/test`
`pista`	`hint`	`POST /v1/tenant/webhook/test`
`mensaje`	`message`	`POST /v1/tenant/webhook/test` y el evento `webhook.test`
`beneficiarios`	`beneficiaries`	`POST /v1/test-helpers/seed`
`banco`	`bank`	`POST /v1/test-helpers/seed`
`saldo`	`balance`	`POST /v1/test-helpers/seed`
`sembrado`	`seeded`	`POST /v1/test-helpers/seed`
`siguiente`	`next`	Ayudas de prueba
`prefondeo`	`prefunding`	`POST /v1/test-helpers/seed`
`prefondeoPruebas`	`testPrefund`	`POST /v1/test-helpers/seed`
`resultado`	`outcome`	`POST /v1/test-helpers/payments/{id}/resolve`
`motivo`	`reason`	`POST /v1/test-helpers/payments/{id}/resolve`
`cliente`	`client`	Conexiones MCP
`permiso`	`permission`	Conexiones MCP
`creadaEn`	`createdAt`	Conexiones MCP
`venceEn`	`expiresAt`	Conexiones MCP
`ultimoUsoEn`	`lastUsedAt`	Conexiones MCP
`revocadaEn`	`revokedAt`	Conexiones MCP

Valores

Campo	Antes	Ahora
`environment`	`pruebas`	`sandbox`
`environment`	`real`	`production`
`funding.model`	`prefondeado`	`prefunded`
`funding.model`	`cierre_diario`	`daily_settlement`
`funding.model`	`cuenta_propia`	`own_account`
`funding.model`	`prefondeo_con_tasa`	`rate_locked_prefunding`
`status` (fondeos)	`pendiente`	`pending`
`status` (fondeos)	`aprobado`	`approved`
`status` (fondeos)	`rechazado`	`rejected`
`status` (cuadre)	`sin_lectura`	`no_reading`
`status` (cuadre)	`diferencia`	`difference`
`status` (conexiones MCP)	`activa`	`active`
`status` (conexiones MCP)	`vencida`	`expired`
`status` (conexiones MCP)	`revocada`	`revoked`
`permission` (conexiones MCP)	`lectura`	`read`
`permission` (conexiones MCP)	`lectura_y_pruebas`	`read_and_test`
`type` (líneas del volumen)	`pago`	`payment`
`type` (líneas del volumen)	`devolucion`	`return`
`base` (líneas del volumen)	`venta`	`sale`
`base` (líneas del volumen)	`costo`	`cost`
`setBy`, `recordedBy`, `approvedBy`	`pruebas:simulado`	`test-helpers:simulated`
`setBy`, `recordedBy`, `approvedBy`	`pruebas:<key>`	`test-helpers:<key>`
`reference` (escenarios del sandbox)	`PRUEBA:SETTLED`, `PRUEBA:SUBMITTED`, `PRUEBA:UNKNOWN`, `PRUEBA:TIMEOUT_AFTER_SUBMIT`	`TEST:SETTLED`, `TEST:SUBMITTED`, `TEST:UNKNOWN`, `TEST:TIMEOUT_AFTER_SUBMIT`

method conserva pago_movil y transferencia en las dos versiones.

Códigos de error

Antes	Ahora
`tenant_custodia_propia`	`tenant_self_custody`
`custodio_simulado_solo_pruebas`	`simulated_custody_test_only`
`pruebas_sin_cuenta_propia_simulada`	`test_account_without_simulated_custody`
`tenant_sin_tasa`	`tenant_rate_missing`
`tenant_sin_tasa_venta`	`sell_rate_missing`
`fondeo_referencia_reusada`	`funding_reference_reused`
`pruebas_solo_cuenta_de_pruebas`	`test_account_required`
`tenant_de_pruebas_sin_live`	`test_tenant_no_live_keys`
`key_test_no_en_produccion`	`test_key_not_allowed_in_production`
`pruebas_no_en_produccion`	`test_helpers_not_in_production`
`key_requiere_autorizacion`	`key_authorization_required`
`conexion_mcp_not_found`	`mcp_connection_not_found`
(nueva)	`api_version_unsupported`

También cambian las claves de error.meta:

Antes	Ahora
`requerido`	`required`
`disponible`	`available`
`campo`	`field`
`cuentas`	`accounts`
`errores`	`errors`

Cómo pasarte

Prueba sin cambiar nada
Sección titulada «Prueba sin cambiar nada»

Manda el header BC-Version: 2026-11-03 en tus llamadas de pruebas. Esa petición sale en inglés; las demás, como siempre.
Ventana de terminal
```
curl -s $BASE/v1/tenant/capabilities -H "x-api-key: $KEY" -H "BC-Version: 2026-11-03"
```
Con ese header, GET /v1/tenant/me también te dice en qué versión está fijada tu cuenta (apiVersion).
Cambia tu código
Sección titulada «Cambia tu código»

Las rutas, campos, valores y códigos de las tablas. Mientras dure la ventana aceptamos los dos idiomas en lo que nos mandas, así que puedes cambiarlo por partes. Si mandas el mismo campo en los dos idiomas con valores distintos, recibes 400 validation_failed.
Fija la versión de tu cuenta
Sección titulada «Fija la versión de tu cuenta»
Ventana de terminal
```
curl -s -X PUT $BASE/v1/tenant/api-version -H "x-api-key: $KEY" \
  -H 'content-type: application/json' -d '{"version":"2026-11-03"}'
```
Hace falta el scope tenant:write y queda en tu auditoría. Desde ese momento todo te llega en inglés, webhooks incluidos.
Vuelve atrás si algo se rompe
Sección titulada «Vuelve atrás si algo se rompe»

Mientras dure la ventana (hasta el 2027-02-01) puedes volver a los nombres viejos:
Ventana de terminal
```
curl -s -X PUT $BASE/v1/tenant/api-version -H "x-api-key: $KEY" \
  -H 'content-type: application/json' -d '{"version":"2026-10-22"}'
```
O deja tu cuenta en inglés y manda BC-Version: 2026-10-22 sólo en las llamadas que aún no migraste.

Cómo sabes si te falta algo

Cada respuesta trae BC-Version con la versión con la que salió. Si usaste un nombre viejo (una ruta, un campo, un valor, PRUEBA: o la versión 2026-10-22), la respuesta trae además:

Header	Ejemplo	Qué dice
`Deprecation`	`@1793664000`	Desde cuándo está deprecado (RFC 9745): 3 de noviembre de 2026
`Sunset`	`Mon, 01 Feb 2027 00:00:00 GMT`	Cuándo dejan de existir los nombres viejos (RFC 8594)
`Link`	`<https://qa.bolivarconnect.com/docs/en/guias/migrar-a-ingles/>; rel="deprecation"`	Esta guía

Cuando ya no veas Deprecation ni Sunset, terminaste. Nosotros también vemos qué cuentas siguen usando nombres viejos, para avisarte antes de la fecha.

Si usas el MCP (tu agente)

El MCP ya habla con la API en inglés (BC-Version: 2026-11-03), sea cual sea la versión fijada de tu cuenta. Sus herramientas, sus argumentos y los campos que añade también están en inglés. No hay alias: vuelve a listar las herramientas después del cambio. Si un agente llama a un nombre viejo, recibe tool_not_available con el nuevo.

Antes	Ahora
`bc_quien_soy`	`bc_whoami`
`bc_bdv_conexion`	`bc_bdv_connection`
`bc_bdv_saldo`	`bc_bdv_balance`
`bc_bdv_pagos_hoy`	`bc_bdv_incoming_payments_today`
`bc_bdv_comisiones`	`bc_bdv_fees`
`bc_bdv_metricas`	`bc_bdv_metrics`
`bc_pagos_listar`	`bc_list_payments`
`bc_pago_ver`	`bc_get_payment`
`bc_metricas_dispersion`	`bc_payment_metrics`
`bc_limites_consumo`	`bc_limits_usage`
`bc_bancos`	`bc_list_banks`
`bc_cotizacion_ver`	`bc_get_quote`
`bc_beneficiarios_listar`	`bc_list_beneficiaries`
`bc_beneficiario_ver`	`bc_get_beneficiary`
`bc_eventos_listar`	`bc_list_events`
`bc_evento_ver`	`bc_get_event`
`bc_mi_integracion`	`bc_my_integration`
`bc_checklist_integracion`	`bc_integration_checklist`
`bc_webhook_configurar`	`bc_set_webhook`
`bc_webhook_probar`	`bc_test_webhook`
`bc_prueba_sembrar`	`bc_sandbox_seed`
`bc_prueba_resolver_pago`	`bc_sandbox_resolve_payment`
`bc_prueba_cargar_prefondeo`	`bc_sandbox_credit_prefund`
`bc_posicion`	`bc_get_position`
`bc_inventario`	`bc_get_inventory`
`bc_fondeos`	`bc_list_fundings`
`bc_tasa_venta_ver`	`bc_get_sell_rate`
`bc_volumen_fee`	`bc_volume_and_fee`
`bc_cotizar`	`bc_create_quote`
`bc_tasa_venta_fijar`	`bc_set_sell_rate`
`bc_beneficiario_crear`	`bc_create_beneficiary`
`bc_dispersar`	`bc_create_payout`
`bc_prefondeo_listar`	`bc_list_prefunds`
`bc_prefondeo_ver`	`bc_get_prefund`
`bc_prefondeo_consumos`	`bc_list_prefund_consumptions`
`bc_prefondeo_cotizar`	`bc_prefund_quote`
`bc_prefondeo_wallets_listar`	`bc_list_source_wallets`
`bc_prefondeo_wallet_registrar`	`bc_register_source_wallet`
`bc_prefondeo_wallet_baja`	`bc_deactivate_source_wallet`
`bc_prefondeo_avisar_envio`	`bc_prefund_mark_sent`
`bc_cuadrar_dia`	`bc_reconcile_day`
`bc_cuadres_cuenta_propia`	`bc_list_daily_closes`
`bc_giftcards_catalogo`	`bc_giftcards_catalog`
`bc_giftcards_programa`	`bc_giftcards_program`
`bc_giftcards_listar`	`bc_list_giftcards`
`bc_giftcard_ver`	`bc_get_giftcard`
`bc_giftcard_emitir`	`bc_issue_giftcard`
`bc_giftcards_marca_configurar`	`bc_set_giftcards_brand`
`bc_conectar_mi_empresa`	`bc_connect_my_company`
`bc_entornos`	`bc_environments`
`bc_obtener_key`	`bc_get_api_key`
`bc_solicitar_acceso_pruebas`	`bc_request_sandbox_access`
(nueva)	`bc_docs` (la documentación publicada, también esta guía)

Argumentos que cambian de nombre:

Herramienta	Antes	Ahora
Toda herramienta 🔒	`confirmacion`	`confirmation`
`bc_bdv_incoming_payments_today`	`limite`	`limit`
`bc_bdv_fees`, `bc_bdv_metrics`	`periodo` (`hoy`)	`period` (`today`)
`bc_list_fundings`	`estado` (`pendiente`, `aprobado`, `rechazado`)	`status` (`pending`, `approved`, `rejected`)
`bc_volume_and_fee`	`desde`, `hasta`	`from`, `to`
`bc_create_quote`	`entregar`, `gastar`, `activo`	`deliverAmount`, `spendAmount`, `spendAsset`
`bc_set_sell_rate`	`tasa`, `confirmoVariacion` (`si`)	`rate`, `confirmLargeChange` (`yes`)
`bc_sandbox_resolve_payment`	`resultado`, `motivo`	`outcome`, `reason`
`bc_list_prefunds`	`estado` (`cotizado`, `enviado`, `recibido`, `cargado`, `consumido`, `vencido`, `rechazado`)	`status` (`quoted`, `sent`, `received`, `credited`, `consumed`, `expired`, `rejected`)
`bc_prefund_quote`	`montoUsdt`, `montoBs`	`amountUsdt`, `amountBs`
`bc_list_source_wallets`	`estado` (`pendiente`, `activa`, `rechazada`, `baja`)	`status` (`pending`, `active`, `rejected`, `deactivated`)
`bc_register_source_wallet`	`red`, `direccion`, `etiqueta`	`network`, `address`, `label`
`bc_deactivate_source_wallet`	`motivo`	`reason`
`bc_prefund_mark_sent`	`referencia`, `montoUsdt`, `direccionOrigen`	`reference`, `amountUsdt`, `sourceAddress`
`bc_reconcile_day`	`dia`	`date`
`bc_list_giftcards`	`status` (`pendiente`, `activa`, `usada`, `expirada`, `fallida`)	`status` (`pending`, `active`, `redeemed`, `expired`, `failed`)
`bc_set_giftcards_brand`	`nombre`, `radio`, `pie_legal`, `marcas` (`todas`)	`name`, `radius`, `legalFooter`, `brands` (`all`)
`bc_set_giftcards_brand`	`color_primario`, `color_acento`, `color_fondo`, `color_superficie`, `color_texto`, `color_texto_secundario`	`colorPrimary`, `colorAccent`, `colorBackground`, `colorSurface`, `colorText`, `colorSecondaryText`
`bc_set_giftcards_brand`	`texto_titulo`, `texto_boton_pagar`, `texto_boton_secundario`, `texto_regalo_para`	`textTitle`, `textPayButton`, `textSecondaryButton`, `textGiftFor`
`bc_set_giftcards_brand`	`soporte_whatsapp`, `soporte_email`, `soporte_url`	`supportWhatsapp`, `supportEmail`, `supportUrl`
`bc_request_sandbox_access`	`empresa`	`company`

Lo que devuelve cada herramienta va envuelto igual, ahora en inglés: datos → data, datos_no_confiables → untrusted_data, nota → note. Una herramienta 🔒 que prepara devuelve requires_confirmation, summary, confirmation, expires_at, expires_in_seconds y next_step (antes: requiere_confirmacion, resumen, confirmacion, vence_en, vence_en_segundos y siguiente_paso). Los campos del prefondeo, del programa de gift cards y de los cobros BDV llegan como los da hoy la API, hasta que esas partes pasen a inglés.

También pasan a inglés los códigos de error propios del MCP, los prompts (y sus argumentos) y las URI de los recursos, también sin alias (un prompt o un recurso con el nombre viejo responde con el nuevo):

Error del MCP antes	Ahora
`mcp_confirmacion_invalida`	`mcp_confirmation_invalid`
`mcp_confirmacion_vencida`	`mcp_confirmation_expired`
`mcp_cotizacion_vencida`	`mcp_quote_expired`
`mcp_tope_superado`	`mcp_cap_exceeded`
`mcp_cupo_escritura`	`mcp_write_rate_limited`
`mcp_escritura_live_no_habilitada`	`mcp_write_live_not_allowed`
`mcp_escritura_solo_tenant_de_pruebas`	`mcp_write_sandbox_account_only`
`mcp_escritura_deshabilitada`	`mcp_write_disabled`
`mcp_conectar_empresa`	`mcp_connect_company`
`mcp_solicitudes_agotadas`	`mcp_signup_requests_exhausted`
`mcp_giftcards_marca_cambio`	`mcp_giftcards_brand_changed`

Prompt antes	Ahora
`que_puedo_hacer`	`what_can_i_do`
`empezar`	`get_started`
`primera_dispersion`	`first_payout`
`cuadrar_dia`	`reconcile_day`
`prefondeo`	`prefund`
`primera_giftcard`	`first_giftcard`

Prompt	Argumento antes	Ahora
`first_payout`	`montoBs`	`amountBs`
`reconcile_day`	`dia`	`date`
`prefund`	`montoUsdt`	`amountUsdt`
`first_giftcard`	`montoUsd`	`amountUsd`

Recurso antes	Ahora
`bc://guia/integracion`	`bc://guide/integration`
`bc://guia/mcp`	`bc://guide/mcp`
`bc://guia/modelos-de-fondeo`	`bc://guide/funding-models`
`bc://guia/giftcards`	`bc://guide/giftcards`
`bc://referencia/errores`	`bc://reference/errors`
`bc://referencia/estados`	`bc://reference/statuses`