NubeFact MCP by usefulapi

Issue, void and check facturas, boletas and notes sent to SUNAT in NubeFact.

使うべきか

品質と安全性

A
説明の品質
90%
スキーマの完全性
95%
命名の品質
80%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~2,140トークン数(ツール定義)
~4.7 KB一般的なレスポンスサイズ
注意への影響は中程度(128k コンテキストの 1.67%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "nubefact": {
      "url": "https://nubefact.usefulapi.io/mcp"
    }
  }
}

リモートエンドポイント

https://nubefact.usefulapi.io/mcpstreamable-http

できること

ツール一覧

ツール(4)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🔴nubefact_issue_document(tipo_de_comprobante, serie, numero, fecha_de_emision, moneda, ...)

Issue an electronic factura (tipo 1), boleta (tipo 2), credit note (tipo 3) or debit note (tipo 4) through NubeFact, which sends it to SUNAT. Totals are computed from the lines (IGV 18% on gravado lines). This creates a legal document: it cannot be edited or deleted. Void a wrong one with nubefact_void_document. Check the series and number first with nubefact_get_document. Operation: generar_comprobante.

入力スキーマ

{
  "type": "object",
  "properties": {
    "tipo_de_comprobante": {
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        },
        {
          "type": "number",
          "const": 3
        },
        {
          "type": "number",
          "const": 4
        }
      ],
      "description": "1 = factura, 2 = boleta, 3 = nota de crédito, 4 = nota de débito."
    },
    "serie": {
      "type": "string",
      "pattern": "^[FB][A-Z0-9]{3}$",
      "description": "Series, 4 characters. Starts with F for facturas, B for boletas (notes take the series of their document)."
    },
    "numero": {
      "type": "integer",
      "minimum": 1,
      "maximum": 99999999,
      "description": "Document number, no leading zeros."
    },
    "fecha_de_emision": {
      "type": "string",
      "pattern": "^\\d{2}-\\d{2}-\\d{4}$",
      "description": "Issue date, dd-mm-yyyy (must be today)."
    },
    "moneda": {
      "default": 1,
      "description": "1 = soles, 2 = dólares, 3 = euros, 4 = libra esterlina.",
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "tipo_de_cambio": {
      "description": "Exchange rate to soles (3 decimals). Required when moneda is not 1.",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "cliente_tipo_de_documento": {
      "type": "string",
      "enum": [
        "0",
        "1",
        "4",
        "6",
        "7",
        "-",
        "A",
        "B",
        "G"
      ],
      "description": "6 = RUC, 1 = DNI, - = varios (sales under S/700), 4 = carnet de extranjería, 7 = pasaporte, A = cédula diplomática, B = documento de identidad del país de residencia, 0 = no domiciliado (exportación), G = salvoconducto."
    },
    "cliente_numero_de_documento": {
      "type": "string",
      "minLength": 1,
      "maxLength": 15
    },
    "cliente_denominacion": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Customer name or company name."
    },
    "cliente_direccion": {
      "description": "Customer address (optional for boletas).",
      "type": "string",
      "maxLength": 100
    },
    "cliente_email": {
      "description": "Customer email. NubeFact emails the document only when enviar_automaticamente_al_cliente is true.",
      "type": "string",
      "maxLength": 250,
      "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"
    },
    "enviar_automaticamente_al_cliente": {
      "default": false,
      "description": "Email the document to the customer.",
      "type": "boolean"
    },
    "enviar_automaticamente_a_la_sunat": {
      "default": true,
      "description": "Send the document to SUNAT now (default true).",
      "type": "boolean"
    },
    "observaciones": {
      "description": "Notes printed on the document.",
      "type": "string",
      "maxLength": 1000
    },
    "items": {
      "minItems": 1,
      "maxItems": 250,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "codigo": {
            "description": "Your internal product or service code (optional).",
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "descripcion": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250,
            "description": "Item description."
          },
          "unidad_de_medida": {
            "type": "string",
            "enum": [
              "NIU",
              "ZZ"
            ],
            "description": "NIU = product, ZZ = service."
          },
          "cantidad": {
            "type": "number",
            "exclusiveMinimum": 0,
            "description": "Quantity."
          },
          "valor_unitario": {
            "type": "number",
            "minimum": 0,
            "description": "Unit value WITHOUT IGV. The tool adds the IGV (18%)."
          },
          "tipo_de_igv": {
            "anyOf": [
              {
                "type": "number",
                "const": 1
              },
              {
                "type": "number",
                "const": 8
              },
              {
                "type": "number",
                "const": 9
              }
            ],
            "description": "1 = gravado (taxed, IGV 18%), 8 = exonerado (exempt), 9 = inafecto (not taxed)."
          },
          "codigo_producto_sunat": {
            "description": "SUNAT product code, 8 digits (optional).",
            "type": "string",
            "pattern": "^\\d{8}$"
          }
        },
        "required": [
          "descripcion",
          "unidad_de_medida",
          "cantidad",
          "valor_unitario",
          "tipo_de_igv"
        ]
      },
      "description": "Document lines. Totals are computed from these lines."
    },
    "documento_que_se_modifica": {
      "description": "The document a note changes. Required for notes (tipo 3 and 4).",
      "type": "object",
      "properties": {
        "tipo_de_comprobante": {
          "anyOf": [
            {
              "type": "number",
              "const": 1
            },
            {
              "type": "number",
              "const": 2
            }
          ],
          "description": "1 = factura, 2 = boleta."
        },
        "serie": {
          "type": "string",
          "pattern": "^[FB][A-Z0-9]{3}$",
          "description": "Series, 4 characters. Starts with F for facturas, B for boletas (notes take the series of their document)."
        },
        "numero": {
          "type": "integer",
          "minimum": 1,
          "maximum": 99999999,
          "description": "Document number, no leading zeros."
        }
      },
      "required": [
        "tipo_de_comprobante",
        "serie",
        "numero"
      ]
    },
    "motivo_de_nota": {
      "description": "Note reason code. Credit notes 1-13 (1 = anulación de la operación, 6 = devolución total). Debit notes 1-5 (1 = intereses por mora, 3 = penalidades). Required for notes.",
      "type": "integer",
      "minimum": 1,
      "maximum": 13
    }
  },
  "required": [
    "tipo_de_comprobante",
    "serie",
    "numero",
    "fecha_de_emision",
    "cliente_tipo_de_documento",
    "cliente_numero_de_documento",
    "cliente_denominacion",
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢nubefact_get_document(tipo_de_comprobante, serie, numero)

Read one issued factura, boleta or note: its PDF, XML and CDR links, whether SUNAT accepted it, and whether it is voided. Operation: consultar_comprobante.

入力スキーマ

{
  "type": "object",
  "properties": {
    "tipo_de_comprobante": {
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        },
        {
          "type": "number",
          "const": 3
        },
        {
          "type": "number",
          "const": 4
        }
      ],
      "description": "1 = factura, 2 = boleta, 3 = nota de crédito, 4 = nota de débito."
    },
    "serie": {
      "type": "string",
      "pattern": "^[FB][A-Z0-9]{3}$",
      "description": "Series, 4 characters. Starts with F for facturas, B for boletas (notes take the series of their document)."
    },
    "numero": {
      "type": "integer",
      "minimum": 1,
      "maximum": 99999999,
      "description": "Document number, no leading zeros."
    }
  },
  "required": [
    "tipo_de_comprobante",
    "serie",
    "numero"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴nubefact_void_document(tipo_de_comprobante, serie, numero, motivo)

Void (anular) an issued factura, boleta or note. NubeFact sends a voiding communication to SUNAT. The voiding is final: check it later with nubefact_get_void_status. Operation: generar_anulacion.

入力スキーマ

{
  "type": "object",
  "properties": {
    "tipo_de_comprobante": {
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        },
        {
          "type": "number",
          "const": 3
        },
        {
          "type": "number",
          "const": 4
        }
      ],
      "description": "1 = factura, 2 = boleta, 3 = nota de crédito, 4 = nota de débito."
    },
    "serie": {
      "type": "string",
      "pattern": "^[FB][A-Z0-9]{3}$",
      "description": "Series, 4 characters. Starts with F for facturas, B for boletas (notes take the series of their document)."
    },
    "numero": {
      "type": "integer",
      "minimum": 1,
      "maximum": 99999999,
      "description": "Document number, no leading zeros."
    },
    "motivo": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Reason for the voiding, for example \"ERROR DEL SISTEMA\"."
    }
  },
  "required": [
    "tipo_de_comprobante",
    "serie",
    "numero",
    "motivo"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢nubefact_get_void_status(tipo_de_comprobante, serie, numero)

Read the voiding (anulación) of a factura, boleta or note: the SUNAT ticket, whether SUNAT accepted it, and the PDF, XML and CDR links. Operation: consultar_anulacion.

入力スキーマ

{
  "type": "object",
  "properties": {
    "tipo_de_comprobante": {
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        },
        {
          "type": "number",
          "const": 3
        },
        {
          "type": "number",
          "const": 4
        }
      ],
      "description": "1 = factura, 2 = boleta, 3 = nota de crédito, 4 = nota de débito."
    },
    "serie": {
      "type": "string",
      "pattern": "^[FB][A-Z0-9]{3}$",
      "description": "Series, 4 characters. Starts with F for facturas, B for boletas (notes take the series of their document)."
    },
    "numero": {
      "type": "integer",
      "minimum": 1,
      "maximum": 99999999,
      "description": "Document number, no leading zeros."
    }
  },
  "required": [
    "tipo_de_comprobante",
    "serie",
    "numero"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 4 件