# Panadata API — Documentación completa > Volcado consolidado en markdown de todas las páginas de https://platform.panadata.net/docs. > Pensado para LLMs: una sola descarga cubre toda la documentación. > Para un índice corto vea https://platform.panadata.net/llms.txt. > Especificación OpenAPI: https://platform.panadata.net/openapi.en.yml ## /docs/empezar # Documentación de Panadata API La forma más simple de empezar es entender el flujo real de la API: buscar una entidad, elegir el id correcto y enriquecerla con los módulos que necesita. Ruta recomendada ## Empiece por el flujo completo, no por la tabla de endpoints. 3 pasos Paso 1 ### Entienda el flujo Lea [Tu primera consulta](/docs/guias/primera-consulta) para ver la secuencia completa: buscar, elegir `id` y enriquecer. Paso 2 ### Autentíquese Cree su llave en [Autenticación](/docs/guias/autenticacion) y valide primero el servicio y luego su propia conexión. Paso 3 ### Controle datos y costo Use [Parámetro include](/docs/guias/include-parameter) y [Códigos de producto](/docs/conceptos/codigos-de-producto) para pedir solo lo necesario. Si quiere una prueba guiada en la interfaz, primero [inicie sesión](/users/sign_in) y luego use el Sandbox interactivo. ## Lo esencial Estas páginas cubren lo mínimo para pasar de una primera lectura a una integración real. [ ### Tu primera consulta Aprenda el flujo search -\> id -\> include con ejemplos concretos. ](/docs/guias/primera-consulta)[ ### Autenticación Cree su llave API y verifique correctamente el servicio y su conexión. ](/docs/guias/autenticacion)[ ### Parámetro include Controle qué datos recibe y cuánto paga en cada consulta de detalle. ](/docs/guias/include-parameter)[ ### Referencia API Use el contrato completo request/response cuando ya esté listo para integrar. ](/docs/referencia) ## Apoyo para decidir Use estas páginas cuando quiera comparar opciones, entender costos o probar el flujo desde la interfaz. [ ### Sandbox interactivo Requiere cuenta. Inicie sesión para probar el flujo guiado con llamadas reales. ](/users/sign_in)[ ### Códigos de producto Revise qué módulos están activos hoy, qué niveles incluyen y cuáles siguen TBD. ](/docs/conceptos/codigos-de-producto)[ ### Precios y saldo prepago Entienda el cargo base, la resolución inteligente y cómo el panel descuenta el saldo prepago. ](/docs/conceptos/facturacion) --- ## /docs/guias # Guías Instrucciones paso a paso para las tareas más comunes con la API. Escritas para que cualquier persona pueda seguirlas, sin importar su nivel técnico. ## Primeros pasos [ ### Autenticación Cómo obtener su llave API y enviarla en cada solicitud. ](/docs/guias/autenticacion)[ ### Tu primera consulta Buscar, identificar y enriquecer una entidad en 3 pasos. ](/docs/guias/primera-consulta) ## Uso avanzado [ ### Parámetro include Cómo funciona el parámetro include, la resolución inteligente y ejemplos de uso. ](/docs/guias/include-parameter)[ ### Sandbox vs API directa Cuándo usar el sandbox interactivo y cuándo usar su propia llave. ](/docs/guias/sandbox-vs-api)[ ### Errores y solución de problemas Códigos de error HTTP, mensajes comunes y cómo resolverlos. ](/docs/guias/errores) --- ## /docs/guias/autenticacion # Autenticación y llaves API Para usar la API necesita una llave (API key). La llave se envía en cada solicitud como un header de autorización. ## 1. Obtener su llave API Vaya a [Llaves API](/api_keys) en su panel. Ingrese un nombre descriptivo (ej. "Mi app de compliance") y haga clic en crear. Importante: La llave completa solo se muestra **una vez** al momento de crearla. Cópiela y guárdela en un lugar seguro. Si la pierde, deberá crear una nueva. ## 2. Enviar la llave en cada solicitud Incluya la llave en el header `Authorization` con el prefijo `Bearer`: ``` curl 'https://api.panadata.net/v4/panama/entidades?nombre=panadata' \ --header 'Authorization: Bearer pk_su_llave_aqui' ``` ## 3. Verificar el servicio y su llave Primero pruebe con el endpoint de salud (no consume saldo ni requiere autenticación): ``` curl 'https://api.panadata.net/health' ``` Si recibe un JSON como `{"status":"ok","service":"panadata-api"}`, el servicio está disponible. Luego pruebe una búsqueda autenticada con su llave: ``` curl 'https://api.panadata.net/v4/panama/entidades?nombre=banco' \ --header 'Authorization: Bearer pk_su_llave_aqui' ``` ## Errores comunes `401 Unauthorized` No se envió el header Authorization. `403 Forbidden` La llave fue rechazada por la capa de autenticación. `402 Payment Required` No tiene saldo prepago suficiente. [Recargue saldo](/credits) para continuar. Siguiente: [Tu primera consulta →](/docs/guias/primera-consulta) --- ## /docs/guias/primera-consulta # Tu primera consulta Siga estos 3 pasos para buscar y enriquecer una entidad por primera vez. ## Paso 1: Buscar por nombre o RUC Use el endpoint de búsqueda para encontrar entidades por nombre o número de RUC: ``` curl 'https://api.panadata.net/v4/panama/entidades?nombre=panadata' \ --header 'Authorization: Bearer pk_su_llave' ``` La respuesta incluye una lista de coincidencias. Cada resultado tiene un `id` que usará en `GET /v4/panama/entidades/{id}`. ## Paso 2: Identificar la entidad correcta Revise los resultados y tome nota del `id` de la entidad que le interesa. Puede confirmar por nombre, RUC o tipo de entidad. ## Paso 3: Enriquecer con módulos Use el endpoint de detalle con el parámetro `include` para obtener la información que necesita: ``` curl 'https://api.panadata.net/v4/panama/entidades/12345?include=DAT-CORE' \ --header 'Authorization: Bearer pk_su_llave' ``` Puede solicitar múltiples códigos separados por coma: ``` curl 'https://api.panadata.net/v4/panama/entidades/12345?include=DAT-CORE,DAT-GOV,DAT-RISK' \ --header 'Authorization: Bearer pk_su_llave' ``` Consejo: Empiece con `DAT-CORE` para ver los datos básicos. Luego agregue módulos adicionales según lo que necesite. Consulte la lista completa en [Códigos de producto](/docs/conceptos/codigos-de-producto). Anterior: [← Autenticación](/docs/guias/autenticacion) Siguiente: [Parámetro include →](/docs/guias/include-parameter) --- ## /docs/guias/include-parameter # Parámetro include El parámetro include es obligatorio en el endpoint de detalle. Controla qué datos recibe y cuánto paga. ## Sintaxis ``` GET /v4/panama/entidades/{id}?include=CODIGO1,CODIGO2,CODIGO3 ``` Los códigos se separan por coma, sin espacios. El código mínimo es `CHK-BIN`. ## Ejemplos Verificación rápida `?include=CHK-BIN` Solo confirma existencia. Costo: 0.01 + 0.02 = 0.03 cr Perfil básico + gobierno `?include=DAT-CORE,DAT-GOV` Datos de registro, contacto, directores y gobierno. Costo: 0.01 + 0.15 + 0.15 = 0.31 cr Due diligence completo `?include=DAT-ALL` Toda la información disponible. Costo: 0.01 + 1.35 = 1.36 cr ## Resolución inteligente Si solicita códigos que comparten niveles, solo se cobra el más amplio. Por ejemplo, `DAT-CORE` ya incluye el nivel `core_registro` de `CHK-BIN`, así que solicitar ambos solo cobra DAT-CORE. Anterior: [← Primera consulta](/docs/guias/primera-consulta) Siguiente: [Sandbox vs API →](/docs/guias/sandbox-vs-api) --- ## /docs/guias/sandbox-vs-api # Sandbox vs API directa Panadata ofrece dos formas de interactuar con la API: el sandbox interactivo del producto y la API directa con su propia llave. ### Sandbox - + No necesita llave propia - + Experiencia guiada paso a paso - + Ideal para evaluar el producto - - Usa una llave compartida del servidor - - Flujos limitados (buscar → enriquecer) [Ir al Sandbox →](/sandbox) ### API directa - + Control total sobre las solicitudes - + Automatizable desde cualquier lenguaje - + Todos los endpoints y códigos disponibles - - Requiere llave propia y saldo prepago - - Requiere conocimiento básico de APIs [Ver Referencia API →](/docs/referencia) ## Cuándo usar cada uno Use el **sandbox** cuando quiera explorar los datos disponibles antes de comprometerse. Use la **API directa** cuando necesite automatizar consultas desde Postman, scripts o su aplicación. [← Parámetro include](/docs/guias/include-parameter) [Errores →](/docs/guias/errores) --- ## /docs/guias/errores # Errores y solución de problemas Referencia rápida de los códigos de error HTTP que puede recibir y cómo resolverlos. ## Errores de cliente (4xx) `400 Bad Request` La solicitud tiene un formato inválido o faltan parámetros requeridos. Casos comunes: omitir `include` en el detalle, omitir `nombre` y `ruc` en la búsqueda, o enviar un código de producto inválido. `401 Unauthorized` No se envió el header `Authorization: Bearer pk_...`. Solución: Envíe su llave API como Bearer token en cada solicitud. `402 Payment Required` No tiene saldo prepago suficiente para completar la solicitud. Solución: [Recargue saldo](/credits) desde su panel. `403 Forbidden` La llave fue rechazada por la capa de autenticación. Solución: Verifique que está usando una llave activa generada en su cuenta y que la copió completa. `404 Not Found` La entidad con el ID proporcionado no existe. Solución: Verifique el `id` usando el endpoint de búsqueda. ## Errores de servidor (5xx) `500 Internal Server Error` Error interno del servidor. Si persiste, contáctenos. Estas solicitudes **no se cobran**. `503 Service Unavailable` El servicio está temporalmente fuera de línea. Reintente en unos minutos. Anterior: [← Sandbox vs API](/docs/guias/sandbox-vs-api) --- ## /docs/referencia --- ## /docs/conceptos # Conceptos Entienda el modelo de datos, los códigos de producto y cómo se cobra el consumo antes de integrar la API. [ ### Jurisdicciones Vista general: qué países cubre Panadata, sus endpoints, fuentes y niveles disponibles. ](/docs/conceptos/jurisdicciones) [ ### Fuentes de datos Las 28 fuentes gubernamentales y comerciales de Panamá de donde provienen los datos. ](/docs/conceptos/fuentes-de-datos)[ ### Niveles de datos Los 34 niveles atómicos de información que Panadata recopila para cada entidad. ](/docs/conceptos/niveles-de-datos)[ ### Códigos de producto Tabla de códigos activos hoy, sus precios por resultado y los niveles que incluyen. ](/docs/conceptos/codigos-de-producto)[ ### Precios y saldo prepago Cargo base, resolución inteligente y cómo se descuenta el saldo prepago. ](/docs/conceptos/facturacion) --- ## /docs/conceptos/jurisdicciones # Jurisdicciones Panadata organiza sus datos por jurisdicción. Cada jurisdicción tiene su propio endpoint, sus fuentes de datos y sus niveles de datos disponibles. ## Panamá Activa`api.panadata.net/v4/panama/entidades` 28 [Fuentes de datos](/docs/conceptos/fuentes-de-datos) Registro Público, DGI, Aduanas, Órgano Judicial, superintendencias, medios y más. 34 [Niveles de datos](/docs/conceptos/niveles-de-datos) Identidad, directores, activos, comercio exterior, riesgo, expedientes judiciales, noticias y más. 12 [Códigos de producto](/docs/conceptos/codigos-de-producto) Desde CHK-BIN ($0.02) hasta DAT-ALL ($1.35). Combinables con resolución inteligente. Panamá es la jurisdicción principal. Cubre personas jurídicas y naturales del Registro Público y fuentes complementarias. Dos endpoints: | Endpoint | Método | Descripción | | --- | --- | --- | | /v4/panama/entidades | GET | Búsqueda por nombre o RUC. Cargo base: $0.01. | | /v4/panama/entidades/{id} | GET | Detalle y enriquecimiento con `?include=`. | ## Ecuador Por definir`/v4/ecuador/entidades` Fuentes, niveles de datos y códigos de producto para Ecuador están en proceso de definición. El endpoint seguirá la misma estructura que Panamá. ## Colombia Por definir`/v4/colombia/entidades` Fuentes, niveles de datos y códigos de producto para Colombia están en proceso de definición. El endpoint seguirá la misma estructura que Panamá. ## Estructura común Todas las jurisdicciones siguen el mismo modelo: **fuentes** alimentan **niveles de datos** , que se empaquetan en **códigos de producto** que usted solicita con `?include=`. Los endpoints, precios y niveles disponibles varían por jurisdicción, pero la mecánica de la API es la misma. --- ## /docs/conceptos/fuentes-de-datos # Fuentes de datos Panadata recopila información de 28 fuentes oficiales y comerciales de Panamá. Cada fuente alimenta uno o más niveles de datos que usted consulta a través de la API. Las 28 fuentes listadas a continuación aplican a la jurisdicción de Panamá. Las fuentes de Ecuador y Colombia están por definir. Consulte [Jurisdicciones](/docs/conceptos/jurisdicciones) para la vista general. ## Panamá — 28 fuentes Cada fila muestra la fuente, los datos que se obtienen de ella y los [niveles de datos](/docs/conceptos/niveles-de-datos) que alimenta. Panamá ## Registros gubernamentales | Fuente | Sigla | Datos obtenidos | Niveles de datos | | --- | --- | --- | --- | | Registro Público de Panamá | RP | Personas jurídicas y naturales, directores, documentos/escrituras, fincas, propiedades horizontales, bienes muebles, naves, fideicomisos, organizaciones relacionadas | `core_registro``directores``documentos_escaneados``documentos_digitales``propiedades``fincas``bienes_muebles``naves``fideicomisos``organizaciones``suspension` | | Registro Mercantil de Naves | RMN | Registro de naves, propietarios, matrícula, historial | `naves` | Panamá ## Agencias gubernamentales | Fuente | Sigla | Datos obtenidos | Niveles de datos | | --- | --- | --- | --- | | Dirección General de Ingresos | DGI | RUC, estado de ITBM | `core_registro` | | Autoridad Nacional de Aduanas | ANA | Importaciones, exportaciones, puertos de entrada/salida, valores CIF/FOB, información arancelaria | `exportaciones``importaciones``customs_summary``recent_exports_summary``recent_imports_summary` | | PanamáEmprende (AMPYME) | AMPYME | Avisos de operación, código, RUC, vigencia, actividades CIIU, representante legal, certificaciones | `avisos` | | Contraloría General de la República | CGR | Datos de control (SCAFID), montos, proceso de refrendo, datos del favorecido | `documentos_contraloria` | | Caja del Seguro Social | CSS | Datos del deudor y monto adeudado (listado de morosos) | `css_moroso_menciones` | | Dir. Gral. de Registro de la Propiedad Industrial | DIGERPI | Marcas registradas, clasificación, etiquetas, historial | `marcas` | | Ministerio de Trabajo y Desarrollo Laboral | MITRADEL | Permisos de trabajo, identificaciones (pasaportes, carnés), empresa contratante | `work_permits``permisos_trabajo` | | Servicio Nacional de Migración | SNM | Trámites de residencia, estado, abogado representante, historial | `migrations` | | Dir. Gral. de Contrataciones Públicas — Sanciones | DGCP-Sanc | Inhabilitados para contratar con el Estado | `sanciones` | | Ministerio de Comercio e Industrias | MICI | Idoneidades de contadores públicos autorizados | `idoneidades` | Panamá ## Plataformas gubernamentales | Fuente | Sigla | Datos obtenidos | Niveles de datos | | --- | --- | --- | --- | | PanamáCompra (DGCP) | PanamáCompra | Actos públicos, documentos en PDF, propuestas presentadas, proponentes, adjudicaciones | `licitaciones` | | Canal de Panamá (ACP) | ACP | Licitaciones (sistema propio), planillas de funcionarios, inhabilitados para contratar | `licitaciones``funcionario``sanciones` | | Gaceta Oficial de la República de Panamá | Gaceta | Coincidencias con personas naturales y jurídicas en PDFs publicados | `gacetas` | Panamá ## Poder judicial | Fuente | Sigla | Datos obtenidos | Niveles de datos | | --- | --- | --- | --- | | Órgano Judicial | OJ | Entradas de procesos (civiles, laborales, familia), edictos asociados | `expedientes_judiciales` | | Órgano Judicial — Idoneidades | OJ-Idon | Idoneidades de abogados | `idoneidades` | | Defensoría del Pueblo | DP | Planillas: nombre, salario, posición de funcionarios | `funcionario` | Panamá ## Reguladores | Fuente | Sigla | Datos obtenidos | Niveles de datos | | --- | --- | --- | --- | | Superintendencia de Bancos | SBP | Multas/sanciones, licencias de ejecutivos autorizados | `sanciones``licencias` | | Superintendencia del Mercado de Valores | SMV | Multas/sanciones, licencias de corredores de bolsa y ejecutivos | `sanciones``licencias` | | Superintendencia de Seguros y Reaseguros | SSRS | Multas/sanciones, licencias de corredores de seguros | `sanciones``licencias` | | Superintendencia de Sujetos No Financieros | SSNF | Multas/sanciones | `sanciones``licencias` | | Junta Técnica de Ingeniería y Arquitectura | JTIA | Idoneidades de ingenieros y arquitectos | `idoneidades` | Panamá ## Comerciales y medios | Fuente | Sigla | Datos obtenidos | Niveles de datos | | --- | --- | --- | --- | | Bolsa Latinoamericana de Valores | Latinex | Estados financieros auditados, datos de contacto de empresas públicas | `contacto` | | Páginas Amarillas | PA | Direcciones y teléfonos de contacto | `contacto` | | Medios digitales locales (agregado) | Prensa Local | Publicaciones en medios digitales panameños | `noticias` | | Medios internacionales (agregado) | Prensa Global | Noticias globales | `noticias_globales` | Panamá ## APIs de terceros | Fuente | Sigla | Datos obtenidos | Niveles de datos | | --- | --- | --- | --- | | API externa de sanciones internacionales | Sanctions API | Screening contra 51 listas internacionales de sanciones y PEP (OFAC, ONU, UE, Canadá, Reino Unido, Suiza, entre otras) | `sanciones_internacionales` | --- ## /docs/conceptos/niveles-de-datos # Niveles de datos Cada nivel de datos es una unidad atómica de información sobre una entidad. Panadata recopila 34 niveles de 28 fuentes gubernamentales y comerciales de Panamá. Usted los adquiere agrupados en códigos de producto. Los niveles de datos no se compran individualmente. Se agrupan en [códigos de producto](/docs/conceptos/codigos-de-producto) que usted solicita con el parámetro `?include=`. Para ver de dónde proviene cada nivel, consulte [Fuentes de datos](/docs/conceptos/fuentes-de-datos). Los 34 niveles listados a continuación aplican a la jurisdicción de Panamá. Ecuador y Colombia están por definir. Consulte [Jurisdicciones](/docs/conceptos/jurisdicciones) para la vista general. O OrganizaciónP Persona ## Identidad y registro | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | core\_registro | Campos base de identidad: nombre, RUC/cédula, ficha, folio, tipo, fecha de registro, estado, vigencia, capital, domicilio, scores de actividad comercial. | Registro Público / DGI | OP | | contacto | Datos de contacto disponibles: teléfono, dirección, fechas de actualización. | Latinex / Páginas Amarillas | OP | | entity\_events | Timeline cronológico de eventos de la entidad (hasta 100): cambios de estado, actualizaciones de registro. | Panadata (calculado) | OP | ## Gobierno corporativo | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | directores | Miembros de la junta directiva: cargo, nombre, estado activo. | Registro Público | O | | suspension | Detalle de suspensión de la entidad: fecha y motivo. | Registro Público | O | | organizaciones | Organizaciones donde la entidad tiene participación como miembro o directivo. | Registro Público | OP | | representante\_legal\_identificado | Representante legal identificado de la entidad. | Registro Público | O | | funcionario | Información de planillas del Estado: salario, posición, institución. | Planillas del Estado | P | | gacetas | Menciones en la Gaceta Oficial de Panamá. Señal de posible PEP. | Gaceta Oficial | OP | | documentos\_contraloria | Documentos y trámites de la Contraloría General: montos, proceso de refrendo, favorecido. | Contraloría General | OP | ## Actividad comercial | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | avisos | Avisos de operación de Panamá Emprende con actividad ISIC/CIIU, vigencia, representante legal. | Panamá Emprende (AMPYME) | O | | licencias | Licencias comerciales y profesionales de múltiples entes reguladores. | Entes reguladores | OP | | fideicomisos | Fideicomisos donde participa la entidad. | Registro Público | OP | | marcas | Marcas registradas: clasificación, etiquetas, historial. | DIGERPI | OP | ## Activos | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | propiedades | Propiedades horizontales con hipotecas, compraventas, propietarios. | Registro Público | OP | | fincas | Fincas con hipotecas, compraventas, propietarios. | Registro Público | OP | | bienes\_muebles | Vehículos y bienes muebles registrados. | Registro Público | OP | | naves | Naves y embarcaciones registradas: matrícula, propietarios, historial. | Registro Público | O | ## Comercio internacional | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | exportaciones | Historial detallado de exportaciones aduaneras: valores FOB, destinos, partidas arancelarias. | Autoridad Nacional de Aduanas | O | | importaciones | Historial detallado de importaciones aduaneras: valores CIF, orígenes, partidas arancelarias. | Autoridad Nacional de Aduanas | O | | customs\_summary | Resumen agregado de actividad de comercio exterior. | Autoridad Nacional de Aduanas | O | | recent\_exports\_summary | Resumen mensual de exportaciones recientes. | Autoridad Nacional de Aduanas | O | | recent\_imports\_summary | Resumen mensual de importaciones recientes. | Autoridad Nacional de Aduanas | O | ## Riesgo y compliance | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | sanciones | Sanciones de entes reguladores nacionales (SBP, SMV, SSRS, SSNF, DGCP, ACP). | Entes reguladores | OP | | sanciones\_internacionales | Screening contra listas internacionales: OFAC, Naciones Unidas, UE, Canadá, Reino Unido, Suiza y más. | API externa (tercero) | OP | | expedientes\_judiciales | Expedientes del Órgano Judicial: procesos civiles, laborales, familia, edictos. | Órgano Judicial | OP | | css\_moroso\_menciones | Menciones en listados de morosos de la Caja de Seguro Social. | Caja del Seguro Social | OP | | idoneidades | Idoneidades profesionales registradas: abogados, contadores, ingenieros, arquitectos. | Entes reguladores | OP | ## Documentos | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | documentos\_escaneados | PDFs escaneados del Registro Público: escrituras, poderes, actas. | Registro Público | OP | | documentos\_digitales | Asientos electrónicos del Registro Público. | Registro Público | OP | ## Laboral y migración | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | work\_permits | Permisos de trabajo asociados a la organización. | MITRADEL / SNM | OP | | migrations | Trámites de residencia del Servicio Nacional de Migración: estado, abogado, historial. | SNM | OP | | permisos\_trabajo | Permisos laborales MITRADEL para personas: identificación, pasaporte, empresa contratante. | MITRADEL | P | ## Medios y reputación | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | noticias | Menciones en medios de prensa digitales panameños. | Medios locales (agregado) | OP | | noticias\_globales | Menciones en medios de prensa internacionales. | Medios internacionales (agregado) | OP | ## Contrataciones públicas | Nivel | Descripción | Fuente | Aplica | | --- | --- | --- | --- | | licitaciones | Participación en actos públicos de PanamáCompra: propuestas, adjudicaciones, documentos. | PanamáCompra (DGCP) | OP | --- ## /docs/conceptos/codigos-de-producto # Códigos de producto Al enriquecer una entidad con el parámetro ?include=, usted especifica uno o más códigos de producto. Cada código agrega un precio por resultado y desbloquea un conjunto de niveles de datos. ## Códigos activos hoy Los montos de esta tabla son precios por resultado del endpoint de detalle. La búsqueda tiene además un cargo base de $0.01. | Código | Precio por resultado | Niveles incluidos | | --- | --- | --- | | CHK-BIN | $0.02 | core\_registro | | DAT-CORE | $0.15 | core\_registro, contacto, entity\_events | | DAT-HOOK | $0.03 | entity\_events | | DAT-GOV | $0.15 | directores, suspension, organizaciones, representante\_legal\_identificado, gacetas, documentos\_contraloria, is\_itbm, last\_itbm\_date, funcionario | | DAT-BIZ | $0.08 | avisos, licencias, personal\_licenses, company\_licenses, fideicomisos, marcas | | DAT-ASSET | $0.25 | propiedades, fincas, bienes\_muebles, naves | | DAT-TRADE | $0.20 | importaciones, exportaciones, imports\_summary, exports\_summary, customs\_summary | | DAT-DOC | $0.06 | documentos\_escaneados, documentos\_digitales, rp\_report\_url | | DAT-RISK | $0.20 | css\_moroso\_menciones, sanciones, idoneidades, expedientes\_judiciales | | DAT-PROC | $0.05 | licitaciones | | DAT-NEWS | $0.12 | noticias, noticias\_globales | | DAT-LEGAL | $0.10 | migrations, work\_permits | ## Códigos en evaluación Estos ítems tienen definición interna de producto, pero no forman parte del contrato self-service actual. Hasta que aparezcan como activos en la referencia y en esta tabla principal, trátelos como roadmap. | Código | Estado | Niveles previstos | | --- | --- | --- | | DAT-CGR | Evaluación interna | documentos\_contraloria, fideicomisos | | DAT-IP | Evaluación interna | marcas | | DAT-LABOR | Evaluación interna | migrations, work\_permits, funcionario | | DAT-SCREEN | Pipeline | funcionario, sanciones\_internacionales | ## Paquete completo `DAT-ALL`$1.35 por entidad Incluye todos los niveles activos de todos los códigos disponibles en una sola solicitud. Es la opción más conveniente cuando necesita el perfil completo de una entidad. `DAT-ALL+` sigue en evaluación y no debe asumirse disponible hoy en self-service. ## Resolución inteligente Los códigos de producto utilizan resolución inteligente: se ordenan por cantidad de niveles de forma descendente y solo se cobran los códigos no redundantes. Por ejemplo, al solicitar `?include=DAT-CORE,CHK-BIN` solo se cobra **DAT-CORE** porque ya cubre el nivel `core_registro` proporcionado por CHK-BIN. En ese caso, el cargo adicional es **$0.15** , no $0.17. --- ## /docs/conceptos/facturacion # Precios y saldo prepago Panadata cobra montos por solicitud y por enriquecimiento. En el panel, ese consumo se descuenta de un saldo prepago. ## Cómo pensar el cobro Piense en **precios por resultado** , no en tokens abstractos. La búsqueda tiene un cargo base bajo. El detalle agrega el precio del código o paquete que solicite con `include`. En la página de [Uso](/usages), el consumo aparece como costo real en dólares. ## Cargo base Toda solicitud autenticada arranca con un cargo base de **$0.01**. Esto aplica tanto a la búsqueda (`GET /v4/panama/entidades`) como al detalle (`GET /v4/panama/entidades/{id}`). ## Precio por enriquecimiento Cuando utiliza el parámetro `include` en el endpoint de detalle, se agrega el precio por resultado de los [códigos de producto](/docs/conceptos/codigos-de-producto) solicitados. Fórmula del cargo total: cargo\_total = $0.01 base + suma(precios cobrados) ## Resolución inteligente Los códigos de producto utilizan **resolución inteligente** : se ordenan por cantidad de niveles de forma descendente y solo se cobran los códigos no redundantes. Ejemplo: Al solicitar `?include=DAT-CORE,CHK-BIN` solo se cobra **DAT-CORE** ($0.15) porque ya cubre el nivel `core_registro` que proporciona CHK-BIN. El cargo total sería: $0.01 + $0.15 = **$0.16**. ## Cuándo se cobra La facturación ocurre **después** de que la solicitud sea exitosa (solo respuestas 2xx). Si la solicitud falla (4xx o 5xx), no se descuenta saldo. ## Saldo prepago en el panel Puede recargar saldo desde el [panel de recarga](/credits). Para presupuestar, piense en ese saldo como prepago para cubrir cargos por resultado. Si quiere revisar consumo real, use la página de [Uso](/usages), donde el costo se presenta en dólares. --- ## /docs/notas # Notas de versión Historial de cambios de la plataforma y la API de Panadata. 7 de abril de 2026 ## Webhooks y sandbox interactivo - Sandbox autenticado con flujo guiado: búsqueda por nombre, RUC e ID con respuestas reales de la API. - Sistema de webhooks para solicitudes de actualización de entidades con firma KMS. - Hub de documentación rediseñado con ViewComponents y navegación lateral. 23 de marzo de 2026 ## Framework de precios v4 - Actualización de precios por SKU con framework basado en valor. - Especificaciones OpenAPI sincronizadas con el API Gateway de producción. - Parche de seguridad: Devise 5.0.3 (GHSA-57hq-95w6-v4fc). 16 de marzo de 2026 ## Referencia API bilingüe - Especificaciones OpenAPI v4 en español e inglés. - Metadatos de discoverability para agentes de IA (`link rel=describedby`). - Sincronización del nombre de llave API hacia DynamoDB para logging estructurado. 10 de marzo de 2026 ## Localización al español - Toda la interfaz de la plataforma traducida al español. - Copiar al portapapeles en llaves API y sandbox. - Nuevo favicon de Panadata. 3 de marzo de 2026 ## Documentación interactiva - Referencia API interactiva con Scalar (OpenAPI 3.0). - Correcciones en el flujo de checkout de Stripe (CORS, Turbo). 27 de febrero de 2026 ## Dashboard de uso - Gráfico de uso con ejes duales (costo y solicitudes), tooltips y selector de período. - Resumen de estadísticas con totales del período seleccionado. 10 de febrero de 2026 ## Lanzamiento de la plataforma v4 - Plataforma self-service para Panamá: registro, autenticación, llaves API, saldo prepago y consumo. - `GET /v4/panama/entidades` — búsqueda por nombre o RUC. - `GET /v4/panama/entidades/{id}?include=` — detalle y enriquecimiento. - 12 códigos de producto activos: CHK-BIN, DAT-CORE, DAT-HOOK, DAT-GOV, DAT-BIZ, DAT-ASSET, DAT-TRADE, DAT-DOC, DAT-RISK, DAT-PROC, DAT-NEWS, DAT-LEGAL. Paquete completo DAT-ALL a $1.35. - Panel de llaves API con creación y revocación, sincronización a DynamoDB. - Compra de saldo prepago vía Stripe Checkout. - Wallet con créditos atómicos en DynamoDB. --- ## /docs/empresa # Panadata OS Pipelines inteligentes con machine learning y dominio experto, operados por Panadata. Sus datos nunca salen de su infraestructura. ## Cuándo tiene sentido La API self-service funciona bien para consultas directas e integraciones estándar. Panadata OS (PANDOS) es para equipos que necesitan más: procesamiento especializado, modelos de machine learning aplicados a su dominio, y análisis profundo con acompañamiento de nuestro equipo de ingeniería. ## Qué incluye ### Pipelines a medida Similar a los módulos de datos de la API, pero con capas de machine learning, ciencia de datos y estudio detallado de su caso de uso. ### Datos en su infraestructura Todo el procesamiento ocurre dentro de su red. Los datos sensibles nunca salen de su perímetro — Panadata opera de forma remota sin acceso a la información. ### Monitoreo y operación Panadata construye, opera y mantiene cada pipeline. Su equipo ve el estado en tiempo real desde una consola centralizada. ## Qué esperar del proceso El proceso normalmente cubre cuatro frentes: 1. Definición de casos de uso y volumen esperado. 2. Selección de módulos, pipelines y estrategia de costos. 3. Pruebas técnicas en sandbox o entorno controlado. 4. Paso a producción con monitoreo y soporte. Si necesita campos, cobertura o flujos específicos, este es también el momento para alinear requisitos con el equipo de Panadata. ## Siguiente paso ## Hablemos de su caso de uso Comparta su caso de uso, volumen esperado y stack técnico. Así podemos recomendar la integración adecuada y el nivel de soporte correcto. [Contáctenos](mailto:support@panadata.net)