erpnext-errors-api

Implement structured error handling for ERPNext/Frappe API endpoints.

163|53|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/OpenAEC-Foundation/ERPNext_Anthropic_Claude_Development_Skill_Package --skill erpnext-errors-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: erpnext-errors-api
Source: https://github.com/OpenAEC-Foundation/ERPNext_Anthropic_Claude_Development_Skill_Package/tree/main/skills/source/errors/erpnext-errors-api
Command: npx skills add https://github.com/OpenAEC-Foundation/ERPNext_Anthropic_Claude_Development_Skill_Package --skill erpnext-errors-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

ERPNext API development often suffers from inconsistent errors, insecure responses, and missing validations. This Skill provides a comprehensive framework to implement robust, consistent error handling across server and client code in ERPNext/Frappe apps.

Core Features & Use Cases

  • Complete whitelisted method pattern with input validation, permission checks, and exception mapping.
  • API response wrapper for uniform success/error payloads.
  • Client-side error handling guidelines with centralized UI feedback.
  • External API client patterns with retries and structured error management.
  • Webhook handling with validation, idempotency, and safe error reporting.
  • Reference patterns to avoid anti-patterns.

Quick Start

Use the patterns in this Skill to implement end-to-end error handling for a new ERPNext API endpoint.

Frequently Asked Questions about erpnext-errors-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle API errors in ERPNext and Frappe consistently?

To handle ERPNext API errors consistently, apply a unified framework of structured exceptions, input validation, and an API response wrapper for uniform success and error payloads across server and client code.

What is the best way to implement webhook idempotency and retries in Frappe?

Webhook idempotency and retries in Frappe are implemented using structured error management patterns that validate incoming payloads, track processed requests, and safely report errors without exposing sensitive system details.

Does this ERPNext error handling framework work with version 14?

Yes, the ERPNext error handling framework explicitly supports Frappe and ERPNext v14 through v16, applying consistent validation, logging, and exception mapping across whitelisted methods, REST APIs, and client scripts.

How do I avoid anti-patterns when writing whitelisted methods in ERPNext?

Avoid anti-patterns in ERPNext whitelisted methods by following reference patterns that enforce input validation, permission checks, and exception mapping, replacing insecure responses with safe user-facing messages.

Why do my ERPNext client scripts show inconsistent error feedback?

Inconsistent ERPNext client script feedback occurs without centralized UI error handling; applying structured client-side guidelines ensures uniform error display and reliable user-facing messages.

Can I use this framework to manage external API client retries in ERPNext?

Yes, the framework provides external API client patterns for ERPNext that include automated retries and structured error management to reliably handle failed outbound requests.