Skip to main content
Envía una nota de crédito electrónica (tipoDoc "3") al Ministerio de Hacienda. Se usa para anular o ajustar parcialmente una factura emitida previamente.
La nota de crédito requiere un receptor identificado, igual que la factura electrónica.

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.
tipoDoc
string
required
Tipo de documento. Para nota de crédito: "3".
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. Ver Factura Electrónica para la estructura completa del receptor.
detalleServicio
array
required
Líneas de detalle del documento. Ver Factura Electrónica para la estructura completa.
otrosCargos
array
Cargos adicionales. Ver Factura Electrónica para la estructura.
resumenFactura
object
required
Resumen con moneda y totales. Ver Factura Electrónica para la estructura.
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": "6110.0",
    "tipoDoc": "3",
    "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"
    },
    "otrosCargos": [
      {
        "detalle": "911",
        "montoCargo": "165.90",
        "porcentaje": "0.75",
        "nombreTercero": "911",
        "tipoDocumento": "99"
      },
      {
        "detalle": "CR",
        "montoCargo": "221.19",
        "porcentaje": "1.00",
        "nombreTercero": "CR",
        "tipoDocumento": "99"
      }
    ],
    "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": "50628032600310295515400300001010000000010146404019"
}