Descripción

Este servicio permite obtener información oficial y actualizada de una empresa ecuatoriana utilizando su número de Registro Único de Contribuyentes (RUC) y el tipo específico de documento (RUCEC). Proporciona detalles clave sobre la entidad comercial, incluyendo su nombre, estado de cumplimiento de obligaciones, clasificación tributaria y el período de validez del documento consultado.

Para hacer uso de este servicio en una interfaz gráfica te invitamos a ingresar a nuestro client panel de Verifik.

Parámetros

Nombre Tipo ¿Requerido? Descripción Ejemplo
documentType String True Tipo de documento. Parámetro válido: RUCEC. RUCEC
documentType String True Número de documento a consultar, sin espacios ni puntos y además debe ser de 13 dígitos. 1793197955001

Implementación

Consulta

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/ec/company>',
  params: {documentType: 'RUCEC', documentNumber: '1234567891234'},
    headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Respuesta 200 - (Consulta exitosa)

{
    "data": {
        "RUC": "1793197955001",
        "businessName": "PANADERÍA Y PASTELERIA 227 S.A.S.",
        "description": "AL DIA EN SUS OBLIGACIONES",
        "documentNumber": "1793197955001",
        "documentType": "RUCEC",
        "pendingObligations": null,
        "taxpayerClassification": "Otro",
        "validityPeriodDoc": "12 meses"
    },
    "signature": {
        "dateTime": "March 12, 2024 7:39 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "5TN7E"
}

Otras respuestas

Code Descripción Response Body
404 Not Found Información no encontrada {
"code": "NotFound",
"message": "Record not found.",
"signature": { 
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"

} } | | 409 | Conflict | Hace falta suministrar algún parámetro. | { "code": "MissingParameter", "message": "missing documentType\n. missing documentNumber\n" } | | 409 | Conflict | documentType inválido para esta consulta. | { "code": "MissingParameter", "message": "documentType must be one of: [RUCEC]" } |