Saltar al contenido principal

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). PYabc123456 y PYAbc123456 son 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.

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.

precaució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 / varchar distinguen 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​

PY6b3Rr6nRMo   (pago)
CS7lKJ425dbO   (cliente)

Consulta también la sección Resource IDs en la referencia de la API.