Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mipos.co.cr/llms.txt

Use this file to discover all available pages before exploring further.

Registra un nuevo emisor en el sistema con sus credenciales del Ministerio de Hacienda y certificado digital (archivo .p12 codificado en base64).
El campo certificadoHacienda debe ser el archivo .p12 del emisor codificado en base64. Este certificado es emitido por el BCCR (Banco Central de Costa Rica).

​
Request

POST https://{empresa}.mipos.co.cr/api/enviar/emisor

​
Datos del emisor

​
identificacion
number
required
Número de identificación del emisor (cédula física o jurídica).
​
tipoIdentificacion
number
required
Tipo de identificación:
  • 1 — Cédula Física
  • 2 — Cédula Jurídica
  • 3 — DIMEX
  • 4 — NITE
​
codigoActividad
number
required
Código de actividad económica registrado en Hacienda (ej: 4772.0).
​
sucursal
number
required
Número de sucursal. Usar 1 para la sede principal.
​
nombreComercial
string
required
Nombre comercial o razón social del emisor.
​
telefono
string
required
Número de teléfono del emisor.
​
correoElectronico
string
required
Correo electrónico del emisor.

​
Ubicación

​
ubicacion
object
required
Dirección física del emisor.

​
Credenciales de Hacienda

​
ambiente
number
required
Ambiente de Hacienda:
  • 1 — Producción
  • 2 — Pruebas (Sandbox)
​
usuarioHacienda
string
required
Usuario de acceso al sistema de comprobantes electrónicos de Hacienda.
​
claveHacienda
string
required
Clave de acceso al sistema de comprobantes electrónicos (codificada en base64).
​
pinCertificado
string
required
PIN del certificado digital .p12.
​
certificadoHacienda
string
required
Certificado digital .p12 codificado en base64.
curl -X POST https://{empresa}.mipos.co.cr/api/enviar/emisor \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
    "identificacion": 102340568,
    "tipoIdentificacion": 1,
    "codigoActividad": 4772.0,
    "sucursal": 1,
    "nombreComercial": "MI EMPRESA S.A.",
    "telefono": "88180000",
    "correoElectronico": "empresa@ejemplo.com",
    "ubicacion": {
      "provincia": "1",
      "canton": "06",
      "distrito": "01",
      "barrio": "04",
      "direccion": "350 Oeste del Puente Cañas"
    },
    "ambiente": 1,
    "usuarioHacienda": "cpf-01-0234-0567@stag.comprobanteselectronicos.go.cr",
    "claveHacienda": "BASE64_ENCODED_KEY",
    "pinCertificado": "1234",
    "certificadoHacienda": "BASE64_ENCODED_P12_CERTIFICATE"
  }'

{
  "status": "success",
  "message": "Emisor registrado correctamente"
}