Errores comunes

INVALID_API_KEY — 401

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "La API Key no existe o fue revocada."
  }
}

Cómo solucionarlo: verificá que el header sea Authorization: Bearer dk_test_... (con espacio después de Bearer). Regenerá la key en el panel si fue revocada. En sandbox, no olvides X-Environment: sandbox.

INVALID_RUC — 422

{
  "ok": false,
  "error": {
    "code": "INVALID_RUC",
    "message": "El RUC del receptor no es válido.",
    "field": "receptor.ruc"
  }
}

Cómo solucionarlo: el RUC debe incluir dígito verificador con guión (80012345-6). Verificá que el receptor esté activo en el registro tributario. En sandbox podés usar RUCs de prueba del quickstart.

INVALID_TIMBRADO — 422

{
  "ok": false,
  "error": {
    "code": "INVALID_TIMBRADO",
    "message": "El timbrado está vencido o no corresponde al tipo de documento."
  }
}

Cómo solucionarlo: cargá un timbrado vigente en app.difact.co y confirmá que el tipo_documento del request coincida (ej. 1 = factura). Renovación de timbrado ante la SET si está vencido.

SIFEN_REJECTED — 422

{
  "ok": false,
  "error": {
    "code": "SIFEN_REJECTED",
    "message": "SIFEN rechazó el documento.",
    "sifen_code": "0522"
  }
}

Cómo solucionarlo: consultá el sifen_code en la tabla de abajo. Ejemplo 0522: el número de documento ya existe — incrementá el correlativo o revisá duplicados en tu ERP.

ITEM_IVA_INVALID — 400

{
  "ok": false,
  "error": {
    "code": "ITEM_IVA_INVALID",
    "message": "El valor de IVA no está permitido.",
    "field": "items[0].iva"
  }
}

Cómo solucionarlo: el campo iva de cada ítem solo acepta 0, 5 o 10 (porcentaje en Paraguay). No uses decimales ni otros valores.