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"
}커뮤니티
증거