Registrar Emisor

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"
  }'

// Leer el certificado .p12 y codificar en base64
$certificado = base64_encode(file_get_contents('/ruta/certificado.p12'));

$ch = curl_init('https://{empresa}.mipos.co.cr/api/enviar/emisor');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $token,
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        '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' => $certificado,
    ]),
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

import { readFileSync } from 'fs';

// Leer el certificado .p12 y codificar en base64
const certificado = readFileSync('/ruta/certificado.p12').toString('base64');

const response = await fetch('https://{empresa}.mipos.co.cr/api/enviar/emisor', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`,
  },
  body: JSON.stringify({
    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: certificado,
  }),
});

const data = await response.json();

import requests
import base64

# Leer el certificado .p12 y codificar en base64
with open('/ruta/certificado.p12', 'rb') as f:
    certificado = base64.b64encode(f.read()).decode()

response = requests.post(
    'https://{empresa}.mipos.co.cr/api/enviar/emisor',
    headers={'Authorization': f'Bearer {token}'},
    json={
        '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': certificado,
    },
)

data = response.json()

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

{
  "error": "bad_request",
  "message": "Campos requeridos faltantes"
}

{
  "error": "unauthorized",
  "message": "Token inválido o expirado"
}

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

number

required

Número de identificación del emisor (cédula física o jurídica).

number

required

Tipo de identificación:

1 — Cédula Física
2 — Cédula Jurídica
3 — DIMEX
4 — NITE

number

required

Código de actividad económica registrado en Hacienda (ej: 4772.0).

number

required

Número de sucursal. Usar 1 para la sede principal.

string

required

Nombre comercial o razón social del emisor.

string

required

Número de teléfono del emisor.

string

required

Correo electrónico del emisor.

Ubicación

object

required

Dirección física del emisor.

Show Propiedades

string

required

Código de provincia (1-7).

string

required

Código de cantón (2 dígitos).

string

required

Código de distrito (2 dígitos).

string

required

Código de barrio (2 dígitos).

string

required

Dirección detallada en texto libre.

Credenciales de Hacienda

number

required

Ambiente de Hacienda:

1 — Producción
2 — Pruebas (Sandbox)

string

required

Usuario de acceso al sistema de comprobantes electrónicos de Hacienda.

string

required

Clave de acceso al sistema de comprobantes electrónicos (codificada en base64).

string

required

PIN del certificado digital .p12.

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"
  }'

// Leer el certificado .p12 y codificar en base64
$certificado = base64_encode(file_get_contents('/ruta/certificado.p12'));

$ch = curl_init('https://{empresa}.mipos.co.cr/api/enviar/emisor');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $token,
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        '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' => $certificado,
    ]),
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

import { readFileSync } from 'fs';

// Leer el certificado .p12 y codificar en base64
const certificado = readFileSync('/ruta/certificado.p12').toString('base64');

const response = await fetch('https://{empresa}.mipos.co.cr/api/enviar/emisor', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`,
  },
  body: JSON.stringify({
    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: certificado,
  }),
});

const data = await response.json();

import requests
import base64

# Leer el certificado .p12 y codificar en base64
with open('/ruta/certificado.p12', 'rb') as f:
    certificado = base64.b64encode(f.read()).decode()

response = requests.post(
    'https://{empresa}.mipos.co.cr/api/enviar/emisor',
    headers={'Authorization': f'Bearer {token}'},
    json={
        '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': certificado,
    },
)

data = response.json()

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

{
  "error": "bad_request",
  "message": "Campos requeridos faltantes"
}

{
  "error": "unauthorized",
  "message": "Token inválido o expirado"
}

Factura con Exoneración Actualizar Emisor

Visión general

Documentos

Emisor

Consultas Hacienda

Archivos y Webhooks

Request

Datos del emisor

Ubicación

Credenciales de Hacienda

​Request

​Datos del emisor

​Ubicación

​Credenciales de Hacienda

Request

Datos del emisor

Ubicación

Credenciales de Hacienda