{
  "info": {
    "_postman_id": "bbbaa383-cfe9-4ea2-9880-7fcad47d03fc",
    "name": "Socket Studio · API de RUC en línea",
    "description": "Consulta de RUC ecuatoriano en línea (datos al momento).\n\n**Cómo usarla**\n1. Importa este archivo en Postman.\n2. Abre la colección → pestaña **Variables** y pega tu token en `token` (columna *Current value*).\n3. Cambia `ruc` si quieres consultar otro y pulsa **Send**.\n\nEl token va en la cabecera `Authorization: Bearer {{token}}`; la colección ya la envía sola.\n\nDocumentación completa (respuestas, errores, límites y ejemplos de código): https://socket-studio.com/api-docs.html",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{token}}",
        "type": "string"
      }
    ]
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "if (!pm.collectionVariables.get(\"token\")) {",
          "  console.warn(\"Falta el token: pégalo en la variable \\\"token\\\" de la colección (pestaña Variables).\");",
          "}"
        ]
      }
    }
  ],
  "variable": [
    {
      "key": "base_url",
      "value": "https://apiruc.datecu.link",
      "type": "string"
    },
    {
      "key": "ruc",
      "value": "1724718158001",
      "type": "string"
    },
    {
      "key": "token",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Consulta RUC en línea (live)",
      "event": [
        {
          "listen": "test",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (pm.response.code === 403) {",
              "  console.warn(\"403: token vacío, vencido o no corresponde a este producto. Pégalo en la variable \\\"token\\\" de la colección (pestaña Variables). Detalle: https://socket-studio.com/api-docs.html#errores\");",
              "}",
              "pm.test(\"Responde 200\", function () { pm.response.to.have.status(200); });",
              "pm.test(\"El RUC existe (no vino null)\", function () { pm.expect(pm.response.json()).to.not.equal(null); });",
              "pm.test(\"Trae razón social\", function () { var j = pm.response.json(); pm.expect(j && j.razonSocial).to.be.a(\"string\").and.not.empty; });"
            ]
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/ruc/consulta/live/{{ruc}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "ruc",
            "consulta",
            "live",
            "{{ruc}}"
          ]
        },
        "description": "Consulta el RUC al momento y devuelve la ficha del contribuyente con representantes legales y todos sus establecimientos.\n\n- RUC inexistente o mal formado: responde 200 con el cuerpo `null`.\n- Tarda de 1 a 5 segundos y puede pesar decenas de KB si hay muchos establecimientos. Configura un timeout de 60 s.\n\nDocumentación completa: https://socket-studio.com/api-docs.html"
      },
      "response": [
        {
          "name": "200 · RUC encontrado (valores ficticios, abreviado)",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/ruc/consulta/live/{{ruc}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "ruc",
                "consulta",
                "live",
                "{{ruc}}"
              ]
            },
            "description": "Consulta el RUC al momento y devuelve la ficha del contribuyente con representantes legales y todos sus establecimientos.\n\n- RUC inexistente o mal formado: responde 200 con el cuerpo `null`.\n- Tarda de 1 a 5 segundos y puede pesar decenas de KB si hay muchos establecimientos. Configura un timeout de 60 s.\n\nDocumentación completa: https://socket-studio.com/api-docs.html"
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            }
          ],
          "cookie": [],
          "body": "{\n  \"numeroRuc\": \"1790000000001\",\n  \"razonSocial\": \"EMPRESA EJEMPLO S.A.\",\n  \"estadoContribuyenteRuc\": \"ACTIVO\",\n  \"actividadEconomicaPrincipal\": \"ACTIVIDADES DE CONSULTORIA INFORMATICA\",\n  \"tipoContribuyente\": \"SOCIEDADES\",\n  \"regimen\": \"GENERAL\",\n  \"obligadoLlevarContabilidad\": \"SI\",\n  \"agenteRetencion\": \"NO\",\n  \"contribuyenteEspecial\": \"NO\",\n  \"contribuyenteFantasma\": \"NO\",\n  \"transaccionesInexistente\": \"NO\",\n  \"informacionFechasContribuyente\": {},\n  \"representantesLegales\": [],\n  \"establecimientos\": []\n}"
        },
        {
          "name": "200 · RUC no encontrado o mal formado",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/ruc/consulta/live/{{ruc}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "ruc",
                "consulta",
                "live",
                "{{ruc}}"
              ]
            },
            "description": "Consulta el RUC al momento y devuelve la ficha del contribuyente con representantes legales y todos sus establecimientos.\n\n- RUC inexistente o mal formado: responde 200 con el cuerpo `null`.\n- Tarda de 1 a 5 segundos y puede pesar decenas de KB si hay muchos establecimientos. Configura un timeout de 60 s.\n\nDocumentación completa: https://socket-studio.com/api-docs.html"
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            }
          ],
          "cookie": [],
          "body": "null"
        },
        {
          "name": "403 · Sin token o token no aceptado",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/ruc/consulta/live/{{ruc}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "ruc",
                "consulta",
                "live",
                "{{ruc}}"
              ]
            },
            "description": "Consulta el RUC al momento y devuelve la ficha del contribuyente con representantes legales y todos sus establecimientos.\n\n- RUC inexistente o mal formado: responde 200 con el cuerpo `null`.\n- Tarda de 1 a 5 segundos y puede pesar decenas de KB si hay muchos establecimientos. Configura un timeout de 60 s.\n\nDocumentación completa: https://socket-studio.com/api-docs.html"
          },
          "status": "Forbidden",
          "code": 403,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            }
          ],
          "cookie": [],
          "body": "{\n  \"error\": \"Acceso denegado o límite de consultas alcanzado. Necesitas un token válido y un plan premium vigente. Revisa los planes en https://socket-studio.com/api-cedula-ruc.html\",\n  \"plan\": \"premium\",\n  \"mas_info\": \"https://socket-studio.com/api-cedula-ruc.html\"\n}"
        }
      ]
    },
    {
      "name": "Variante: consulta rápida (desde nuestra base)",
      "event": [
        {
          "listen": "test",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (pm.response.code === 403) {",
              "  console.warn(\"403: token vacío, vencido o no corresponde a este producto. Pégalo en la variable \\\"token\\\" de la colección (pestaña Variables). Detalle: https://socket-studio.com/api-docs.html#errores\");",
              "}",
              "pm.test(\"Responde 200\", function () { pm.response.to.have.status(200); });"
            ]
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/ruc/consulta/{{ruc}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "ruc",
            "consulta",
            "{{ruc}}"
          ]
        },
        "description": "La misma ficha servida desde nuestra base de datos. Más veloz (≈0,2 s), pero puede no reflejar cambios muy recientes. Para datos al momento usa «Consulta RUC en línea»."
      },
      "response": []
    }
  ]
}
