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
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
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-httpWas es kann
Tool-Inventar
Tools (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.
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
Nachweis