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.

Envía una factura electrónica (tipoDoc "1") con exoneración de impuestos. La exoneración se aplica dentro del objeto impuesto de cada línea del detalle de servicio.
Existen dos modalidades de exoneración: autorizaciones (emitidas por entidades autorizadas) y gobierno (instituciones públicas con artículo e inciso de ley).

​
Request

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

​
Campos principales

Los campos principales son idénticos a la Factura Electrónica: emisor, numeroReferencia, codigoActividad, tipoDoc ("1"), receptor, folioType, fechaEmision, resumenFactura, otrosCargos.

​
Exoneración en el impuesto

La diferencia está dentro de cada elemento del array impuesto en detalleServicio, que incluye un objeto exoneracion:
​
exoneracion
object
required
Datos del documento de exoneración.

​
Ejemplo: Exoneración estándar (DGTH)

curl -X POST https://{empresa}.mipos.co.cr/api/enviar/items \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
    "emisor": "3102955154",
    "numeroReferencia": 18,
    "codigoActividad": "6201.0",
    "tipoDoc": "1",
    "receptor": {
      "nombre": "JUAN PEREZ GARCIA",
      "telefono": "50684444",
      "identificacion": {
        "tipo": "01",
        "numero": "504300485"
      },
      "correoElectronico": "cliente@ejemplo.com"
    },
    "folioType": "INVOICE",
    "fechaEmision": "2024-08-23T10:30:00-06:00",
    "resumenFactura": {
      "codigoTipoMoneda": {
        "codigoMoneda": "CRC"
      },
      "totalOtrosCargos": "387.09"
    },
    "detalleServicio": [
      {
        "codigo": "8421000000000",
        "detalle": "INTERNET RESIDENCIAL 200 MBPS",
        "cantidad": 1.0,
        "impuesto": [
          {
            "monto": "2875.53",
            "codigo": "01",
            "tarifa": "13",
            "codigoTarifa": "08",
            "exoneracion": {
              "numeroDocumento": "AL-00080875-23",
              "fechaEmision": "2023-10-11T00:00:00",
              "nombreInstitucion": "04",
              "porcentajeExoneracion": 13,
              "tipoDocumento": "04"
            }
          }
        ],
        "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"
      }
    ]
  }'

​
Ejemplo: Exoneración gobierno (con artículo e inciso)

Para instituciones del Estado, se agregan los campos nombreInstitucionOtros, articulo e inciso: 
"exoneracion": {
  "numeroDocumento": "7293",
  "fechaEmision": "1992-04-03T00:00:00",
  "nombreInstitucion": "01",
  "nombreInstitucionOtros": "CAJA COSTARRICENSE DEL SEGURO SOCIAL",
  "porcentajeExoneracion": 13,
  "tipoDocumento": "03",
  "articulo": "2",
  "inciso": 1
}

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