tefacturo MCP by usefulapi

Read SUNAT status, XML, PDF and CDR; emit invoices, receipts, notes and voids in tefacturo.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
100%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,505토큰 (도구 정의)
~1.5 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.96%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

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

원격 엔드포인트

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

할 수 있는 일

도구 목록

도구 (10)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢tefacturo_get_status(serie, numero, tipoComprobante)

Get the three states of one issued document: SUNAT answer (estadoSunat), declaration (estadoComprobante) and mail delivery (estadoEntrega), with the declaration text. Use it before a document is sent again. Read-only.

입력 스키마

{
  "type": "object",
  "properties": {
    "serie": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,4}$",
      "description": "Series of the document, for example FFA2. Invoices start with F, receipts with B."
    },
    "numero": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Correlative number of the document."
    },
    "tipoComprobante": {
      "type": "string",
      "enum": [
        "01",
        "03",
        "07",
        "08"
      ],
      "description": "Document type: 01 invoice, 03 receipt (boleta), 07 credit note, 08 debit note."
    }
  },
  "required": [
    "serie",
    "numero",
    "tipoComprobante"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢tefacturo_get_xml(serie, numero, tipoComprobante)

Get the signed UBL XML of one issued document. The reply holds xmlFirma, the XML in base64, and hashCode (may be null). Read-only.

입력 스키마

{
  "type": "object",
  "properties": {
    "serie": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,4}$",
      "description": "Series of the document, for example FFA2. Invoices start with F, receipts with B."
    },
    "numero": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Correlative number of the document."
    },
    "tipoComprobante": {
      "type": "string",
      "enum": [
        "01",
        "03",
        "07",
        "08"
      ],
      "description": "Document type: 01 invoice, 03 receipt (boleta), 07 credit note, 08 debit note."
    }
  },
  "required": [
    "serie",
    "numero",
    "tipoComprobante"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢tefacturo_get_pdf(serie, numero, tipoComprobante)

Get the printed PDF of one issued document, as a base64 string (decode it to a .pdf file). Read-only.

입력 스키마

{
  "type": "object",
  "properties": {
    "serie": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,4}$",
      "description": "Series of the document, for example FFA2. Invoices start with F, receipts with B."
    },
    "numero": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Correlative number of the document."
    },
    "tipoComprobante": {
      "type": "string",
      "enum": [
        "01",
        "03",
        "07",
        "08"
      ],
      "description": "Document type: 01 invoice, 03 receipt (boleta), 07 credit note, 08 debit note."
    }
  },
  "required": [
    "serie",
    "numero",
    "tipoComprobante"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢tefacturo_get_cdr(serie, numero, tipoComprobante)

Get the SUNAT receipt (CDR) of one document as a base64 ZIP that holds an XML answer from SUNAT. The CDR proves SUNAT accepted the document. Read-only.

입력 스키마

{
  "type": "object",
  "properties": {
    "serie": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,4}$",
      "description": "Series of the document, for example FFA2. Invoices start with F, receipts with B."
    },
    "numero": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Correlative number of the document."
    },
    "tipoComprobante": {
      "type": "string",
      "enum": [
        "01",
        "03",
        "07",
        "08"
      ],
      "description": "Document type: 01 invoice, 03 receipt (boleta), 07 credit note, 08 debit note."
    }
  },
  "required": [
    "serie",
    "numero",
    "tipoComprobante"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢tefacturo_preview_document(documentType, payload)

Render a PDF preview of a document from its JSON, without a number and without a SUNAT filing (the tool sets datosDocumento.numero to 0). Use it to check the layout before tefacturo_emit_invoice. Read-only. Returns base64Pdf.

입력 스키마

{
  "type": "object",
  "properties": {
    "documentType": {
      "type": "string",
      "enum": [
        "factura",
        "boleta",
        "nota-credito",
        "nota-debito"
      ],
      "description": "Which document the preview shows."
    },
    "payload": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC."
    }
  },
  "required": [
    "documentType",
    "payload"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴tefacturo_emit_invoice(payload)

SUNAT FILING, IRREVERSIBLE: files a new invoice (factura, type 01) with SUNAT for this login's RUC. The numero must be new: check the series with tefacturo_get_status first. Use tefacturo_preview_document to check the layout first. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC.

입력 스키마

{
  "type": "object",
  "properties": {
    "payload": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC."
    }
  },
  "required": [
    "payload"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴tefacturo_emit_receipt(payload)

SUNAT FILING, IRREVERSIBLE: files a new receipt (boleta de venta, type 03) for a consumer with SUNAT, through the daily summary. The numero must be new: check the series with tefacturo_get_status first. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC.

입력 스키마

{
  "type": "object",
  "properties": {
    "payload": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC."
    }
  },
  "required": [
    "payload"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴tefacturo_emit_credit_note(payload)

SUNAT FILING, IRREVERSIBLE: files a credit note (nota de crédito, type 07) that adjusts an earlier invoice or receipt. The payload must name the original document in comprobanteAjustado and a motivo. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC.

입력 스키마

{
  "type": "object",
  "properties": {
    "payload": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC."
    }
  },
  "required": [
    "payload"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴tefacturo_emit_debit_note(payload)

SUNAT FILING, IRREVERSIBLE: files a debit note (nota de débito, type 08) that adds a charge to an earlier invoice or receipt. The payload must name the original document in comprobanteAjustado and a motivo. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC.

입력 스키마

{
  "type": "object",
  "properties": {
    "payload": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC."
    }
  },
  "required": [
    "payload"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴tefacturo_void_documents(payload)

SUNAT FILING, IRREVERSIBLE: sends a voiding summary (resumen de baja) that cancels issued invoices or receipts. The payload holds fechaGeneracion, fechaDocumentoBaja and resumenBajaItemList (serie, numero, tipoComprobante 01 or 03, motivo). SUNAT processes it later: check it with tefacturo_get_status. Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC.

입력 스키마

{
  "type": "object",
  "properties": {
    "payload": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Use the same JSON as the tefacturo docs for this document (close2u, datosDocumento, detalleDocumento, emisor, receptor, informacionAdicional). The emisor.numeroDocumentoIdentidad must be this login's RUC; the tool sets it and rejects another RUC."
    }
  },
  "required": [
    "payload"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 10개