Skip to main content
Envía una factura electrónica (tipoDoc "1") al Ministerio de Hacienda a través del API.
Requiere un receptor con identificación válida (cédula física, jurídica, DIMEX o NITE).

​
Request

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

​
Campos principales

​
emisor
string
required
Número de identificación del emisor registrado.
​
numeroReferencia
integer
required
Número consecutivo de referencia del documento.
​
codigoActividad
string
required
Código de actividad económica del emisor (ej: "6201.0").
​
tipoDoc
string
required
Tipo de documento. Para factura electrónica: "1".
​
folioType
string
required
Tipo de folio. Siempre "INVOICE".
​
fechaEmision
string
required
Fecha y hora de emisión en formato ISO 8601.

​
Receptor

​
receptor
object
required
Datos del receptor del documento.

​
Detalle del servicio

​
detalleServicio
array
required
Líneas de detalle del documento.

​
Otros cargos (opcional)

​
otrosCargos
array
Cargos adicionales al documento.

​
Resumen de factura

​
resumenFactura
object
required
Resumen totales del documento.
curl -X POST https://{empresa}.mipos.co.cr/api/enviar/items \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
    "emisor": "3102955154",
    "numeroReferencia": 10,
    "codigoActividad": "6201.0",
    "tipoDoc": "1",
    "receptor": {
      "nombre": "JUAN PEREZ GARCIA",
      "telefono": "50688881234",
      "identificacion": {
        "tipo": "01",
        "numero": "504300485"
      },
      "correoElectronico": "cliente@ejemplo.com"
    },
    "folioType": "INVOICE",
    "otrosCargos": [
      {
        "detalle": "911",
        "montoCargo": "165.90",
        "porcentaje": "0.75",
        "nombreTercero": "911",
        "tipoDocumento": "99"
      }
    ],
    "fechaEmision": "2024-08-23T10:30:00-06:00",
    "resumenFactura": {
      "codigoTipoMoneda": {
        "codigoMoneda": "CRC"
      },
      "totalOtrosCargos": "165.90"
    },
    "detalleServicio": [
      {
        "codigo": "8421000000000",
        "detalle": "INTERNET RESIDENCIAL 200 MBPS",
        "cantidad": 1.0,
        "impuesto": [
          {
            "monto": "2875.53",
            "codigo": "01",
            "tarifa": "13",
            "codigoTarifa": "08"
          }
        ],
        "subTotal": "22119.47",
        "descuento": "0.00",
        "montoTotal": "22119.47",
        "numeroLinea": 1,
        "impuestoNeto": 2875.53,
        "unidadMedida": "Os",
        "precioUnitario": "22119.47",
        "codigoComercial": [
          {
            "tipo": "04",
            "codigo": "I_INT"
          }
        ],
        "montoTotalLinea": 24995.0,
        "unidadMedidaComercial": "Os"
      }
    ]
  }'

{
  "status": "success",
  "message": "Documento enviado correctamente",
  "clave": "50628032600310295515400100001010000000010146404019"
}