Errores

{
  "type": "https://sifende.com.py/docs/solucion-problemas/validation-error",
  "title": "Error de validación",
  "status": 400,
  "detail": "La solicitud contiene 2 error(es) de validación",
  "errores": {
    "receptor.numeroDocumento": "Número de documento es obligatorio",
    "items[0].precioUnitario": "El precio no puede ser negativo"
  }
}

{"error": "Invalid or expired API key"}

{
  "type": "https://api.sifende.com.py/problems/document-archived",
  "title": "Documento archivado",
  "status": 403,
  "detail": "El período de acceso incluido en el plan actual ha finalizado."
}

HTTP/1.1 503 Service Unavailable
Content-Type: application/problem+json

{
  "type": "https://sifende.com.py/docs/solucion-problemas/kude-unavailable",
  "title": "KuDE temporalmente no disponible",
  "status": 503,
  "detail": "El KuDE no está disponible temporalmente.",
  "traceId": "f2f0333f78bfb6a4184cb5a5374685a5"
}

HTTP/1.1 503 Service Unavailable
Retry-After: 2
Content-Type: application/problem+json

{
  "type": "https://sifende.com.py/docs/solucion-problemas/idempotency-upstream-unknown",
  "title": "Resultado SIFEN no confirmado",
  "status": 503,
  "detail": "No se pudo confirmar el resultado en SIFEN; reintentá con la misma Idempotency-Key después del intervalo indicado"
}

HTTP/1.1 409 Conflict
Content-Type: application/problem+json

{
  "type": "https://sifende.com.py/docs/solucion-problemas/idempotency-key-expired",
  "title": "Clave de idempotencia expirada",
  "status": 409,
  "detail": "El resultado asociado a la clave de idempotencia expiró y ya no puede reproducirse; la clave no puede reutilizarse"
}

{
  "type": "https://sifende.com.py/docs/solucion-problemas/validation-error",
  "title": "Error de validación",
  "status": 400,
  "detail": "La solicitud contiene 1 error(es) de validación",
  "errores": {
    "items[0].tasaIVA": "La tasa de IVA debe ser 5, 10 o null para exentos"
  }
}

{
  "type": "https://sifende.com.py/docs/solucion-problemas/invalid-enum-value",
  "title": "Valor de enumeración inválido",
  "status": 400,
  "detail": "El campo 'tipoDocumento' recibió 'INVOICE', que no es un valor permitido.",
  "campo": "tipoDocumento",
  "valorRecibido": "INVOICE",
  "valoresAceptados": [
    {"codigo": "FACTURA_ELECTRONICA", "descripcion": "Factura electrónica"},
    {"codigo": "NOTA_DE_CREDITO_ELECTRONICA", "descripcion": "Nota de crédito electrónica"},
    {"codigo": "NOTA_DE_DEBITO_ELECTRONICA", "descripcion": "Nota de débito electrónica"}
  ]
}

{
  "type": "https://sifende.com.py/docs/solucion-problemas/invalid-format",
  "title": "Formato de campo inválido",
  "status": 400,
  "detail": "El campo 'numeroEstablecimiento' recibió un valor con formato inválido: 'establecimiento-uno'. Se esperaba un número entero",
  "campo": "numeroEstablecimiento",
  "valorRecibido": "establecimiento-uno",
  "tipoEsperado": "número entero",
  "traceId": "f2f0333f78bfb6a4184cb5a5374685a5"
}

{
  "type": "https://sifende.com.py/docs/solucion-problemas/configuracion-incompleta",
  "title": "Configuración del contribuyente incompleta",
  "status": 422,
  "detail": "El contribuyente no tiene un timbrado configurado (contribuyente 42). Cargá el timbrado en Configuración → Timbrado antes de emitir.",
  "campo": "contribuyente.timbrado",
  "configuracion": "TIMBRADO_VIGENTE",
  "accion": "Cargá el timbrado en Configuración → Timbrado antes de emitir.",
  "traceId": "f2f0333f78bfb6a4184cb5a5374685a5"
}

{
  "type": "https://sifende.com.py/docs/solucion-problemas/internal-error",
  "title": "Error interno del servidor",
  "status": 500,
  "detail": "Ocurrió un error inesperado y el resultado de la operación es indeterminado: puede haberse aplicado o no. No reintentes el envío sin antes consultar el estado, porque un reintento a ciegas puede duplicar el documento.",
  "resultadoIndeterminado": true,
  "accion": "Consultá el estado del recurso antes de reenviar. Si no podés determinarlo, contactá a soporte con el traceId.",
  "traceId": "f2f0333f78bfb6a4184cb5a5374685a5"
}