{ "openapi": "3.0.1", "info": { "title": "Validador de RNC DGII para facturación electrónica (e-CF)", "description": "Valide RNC de empresas en el padrón público de la DGII: dígito verificador, estado, razón social, nombre comercial, actividad y régimen. Confirme el RNC del comprador antes de emitir un e-CF. También exporta empresas por nombre, actividad o estado. No consulta cédulas.", "version": "1.6", "x-build-id": "h8n8NjxnFJTfxd9fU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/opendata-cr~dominican-rnc-validator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-opendata-cr-dominican-rnc-validator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/opendata-cr~dominican-rnc-validator/runs": { "post": { "operationId": "runs-sync-opendata-cr-dominican-rnc-validator", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/opendata-cr~dominican-rnc-validator/run-sync": { "post": { "operationId": "run-sync-opendata-cr-dominican-rnc-validator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Modo / Mode", "enum": [ "validate", "search", "export" ], "type": "string", "description": "validate: un resultado por cada RNC de la lista. search y export: empresas del padrón que cumplen los filtros (export es el mismo modo con otro nombre y el mismo evento de cobro). validate: one result per submitted RNC. search and export: registry rows that match the filters; export is the same mode under another name, with the same charge event.", "default": "validate" }, "rncs": { "title": "RNC a validar / RNCs to validate", "type": "array", "description": "Uno por ítem. Se aceptan guiones, espacios y puntos: 1-01-01063-2 y 101010632 son el mismo RNC. Una cédula de 11 dígitos se responde como no soportada, sin datos del padrón y sin cobro. One company RNC per item. Dashes, spaces, and dots are ignored. An 11-digit cédula is returned as unsupported, with no registry data and no charge.", "items": { "type": "string" } }, "maxResults": { "title": "Máximo de resultados / Maximum results", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Máximo de resultados cobrados por ejecución en validate, search y export. Las cédulas y los valores que no son un RNC de 9 dígitos no cuentan ni se cobran. El formulario sugiere 10. Si se omite, search y export devuelven hasta 100 filas y validate procesa toda la lista (hasta 50.000 valores). Por API también se acepta maxItems; si se envían ambos, se usa el menor. Maximum charged results per run for validate, search, and export. Cédulas and other non-RNC values do not count and are not charged. The form suggests 10. If omitted, search and export return up to 100 rows and validate processes the whole list (up to 50,000 values). The API also accepts maxItems; if both are sent, the smaller one applies." }, "nameContains": { "title": "Nombre contiene / Name contains", "type": "string", "description": "Búsqueda y exportación. Coincide con la razón social o el nombre comercial, sin distinguir mayúsculas ni tildes. Search and export. Matches razón social or trade name. Case and accents are ignored." }, "actividadContains": { "title": "Actividad económica contiene / Economic activity contains", "type": "string", "description": "Texto contenido en la actividad económica, sin distinguir mayúsculas ni tildes. La DGII publica ese campo recortado a 30 caracteres. Text contained in the economic activity, ignoring case and accents. DGII cuts this field at 30 characters." }, "status": { "title": "Estado / Status", "type": "array", "description": "Coincidencia exacta, sin distinguir mayúsculas. Valores posibles: ACTIVO, SUSPENDIDO, DADO DE BAJA, CESE TEMPORAL, ANULADO, RECHAZADO. Si se deja vacío, se incluyen todos. Exact match, case ignored. Empty means any status.", "default": [], "items": { "type": "string" } }, "regimen": { "title": "Régimen de pagos / Payment regime", "type": "string", "description": "NORMAL o RST (Régimen Simplificado de Tributación). Si se deja vacío, se incluyen ambos. NORMAL or RST (simplified tax regime). Empty means both." }, "onlyActive": { "title": "Solo ACTIVO / Active only", "type": "boolean", "description": "En búsqueda y exportación, deja solo las empresas con estado ACTIVO, además de los otros filtros. Search and export only: status must be ACTIVO, in addition to the other filters.", "default": false }, "includePrefix5": { "title": "Incluir RNC prefijo 5 / Include prefix-5 personal RNCs", "type": "boolean", "description": "Cerca de 1.800 RNC de 9 dígitos empiezan con 5 y corresponden a personas físicas, en su mayoría extranjeras. La búsqueda y la exportación no los incluyen salvo que se active esta opción. La validación de un RNC puntual sí los devuelve. About 1,800 nine-digit RNCs start with 5 and belong to natural persons. Search and export leave them out unless this is on. A direct validate lookup still returns them.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }