NubeFact MCP by usefulapi
Issue, void and check facturas, boletas and notes sent to SUNAT in NubeFact.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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"
}コミュニティ
エビデンス