NubeFact MCP by usefulapi

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
90%
Vollständigkeit des Schemas
95%
Qualität der Benennung
80%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,140Tokens (Tool-Definitionen)
~4.7 KBTypische Antwortgröße
Mittlere Auswirkung auf die Aufmerksamkeit (1.67% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

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

Remote-Endpunkte

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

Was es kann

Tool-Inventar

Tools (4)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🔴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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet4 Tools