Identificadores de objetos (IDs)
Cada objeto de la API de Debi tiene un identificador único (id). Por ejemplo, un pago es PY..., un cliente CS... y un gateway GW.... El identificador está formado por un prefijo de 2 letras que indica el tipo de objeto, seguido de una cadena corta alfanumérica.
Reglas de uso
- Distinguen mayúsculas y minúsculas (case-sensitive).
PYabc123456yPYAbc123456son dos objetos distintos. Nunca conviertas los IDs a minúsculas ni a mayúsculas. - Son opacos. Trátalos como cadenas exactas; no interpretes su contenido más allá del prefijo de tipo.
- Guárdalos tal cual. Almacena y compara el ID exactamente como lo devuelve la API.
Tipos de objetos y prefijos
Cada ID comienza con un prefijo de 2 letras que identifica el tipo de objeto:
| Prefijo | Objeto |
|---|---|
AC | Cuenta |
BC | Configuración del Portal de Clientes |
BS | Sesión del Portal de Clientes |
CS | Cliente |
EV | Evento |
EX | Informe |
GW | Gateway |
IM | Importación |
IR | Fila de Importación |
LK | Link |
MA | Adhesión |
PM | Método de Pago |
PY | Pago |
RF | Devolución |
SB | Suscripción |
SS | Sesión |
WH | Webhook |
WD | Intento de Entrega de Webhook |
WM | Mensaje de Webhook |
Cómo almacenarlos de forma segura
Si guardas los IDs de Debi en tu sistema, usa almacenamiento sensible a mayúsculas/minúsculas. De lo contrario, dos IDs que solo difieren en la capitalización se pueden fusionar en uno y provocar duplicados, sobrescrituras o problemas de sincronización.
El problema más común ocurre en campos "únicos" que no distinguen mayúsculas de minúsculas. Al guardar dos IDs que solo difieren en la capitalización, el sistema los considera duplicados y rechaza o pisa uno de ellos.
- MySQL / MariaDB: usa una collation binaria, por ejemplo
VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin. - PostgreSQL:
text/varchardistinguen mayúsculas/minúsculas por defecto; no requiere configuración adicional. - Salesforce: al usar un ID de Debi como External ID o campo único, marca la opción "Treat 'ABC' and 'abc' as different values (case sensitive)" en la definición del campo.
- Planillas / hojas de cálculo: las funciones de deduplicación suelen ignorar mayúsculas/minúsculas. Verifica la sensibilidad antes de deduplicar IDs.
Ejemplo: por qué importan las mayúsculas
Imaginá dos pagos distintos cuyos IDs difieren solo en la capitalización de una sola letra:
PYAbcD123ef— un pago de $100 del cliente APYabcD123ef— un pago de $250 del cliente B
Son dos recursos distintos. Si los guardás en un campo único que no distingue mayúsculas/minúsculas —por ejemplo un External Id de Salesforce sin la opción case-sensitive, o una columna MySQL con collation ..._ci— la plataforma trata ambos IDs como el mismo valor. Cuando el segundo pago se sincroniza, o bien:
- se rechaza como duplicado, y el pago de $250 nunca llega a tu sistema; o
- sobrescribe el primer registro, y el pago de $100 del cliente A queda reemplazado por los datos del cliente B.
En ambos casos se pierde un pago real y tu conciliación deja de coincidir con Debi. Almacenar los IDs de forma sensible a mayúsculas/minúsculas evita este problema.
Consulta también la sección Resource IDs en la referencia de la API.