Docs
MCP serverAvailable tools

Update fiscal series

Edit an existing fiscal series code and its development and production counters.

MCP toolupdate_fiscal_series

Purpose

Edit an existing fiscal series code and its folio counters.

Use when
A fiscal series configuration or counter requires an authorized correction.
Do not use when
You are creating or stamping a CFDI.
Required permissions
settings:update
Side effects
Destructive and external
Idempotency
Idempotent

Input schema

JSON Schema
{  "type": "object",  "properties": {    "idempotencyKey": {      "type": "string",      "minLength": 1,      "maxLength": 200,      "description": "Unique retry key for this exact operation. Reuse it only when retrying the same request."    },    "seriesId": {      "type": "string",      "minLength": 1    },    "code": {      "type": "string",      "minLength": 1,      "maxLength": 25,      "pattern": "^[A-Za-z0-9]+$"    },    "nextFolioProduction": {      "$ref": "#/definitions/__schema0"    },    "nextFolioDevelopment": {      "$ref": "#/definitions/__schema0"    }  },  "required": [    "idempotencyKey",    "seriesId",    "code",    "nextFolioProduction",    "nextFolioDevelopment"  ],  "$schema": "http://json-schema.org/draft-07/schema#",  "additionalProperties": false,  "definitions": {    "__schema0": {      "type": "integer",      "minimum": 1,      "maximum": 9007199254740991    }  }}

Output schema

JSON Schema
{  "type": "object",  "properties": {    "data": {      "type": "object",      "properties": {        "seriesId": {          "type": "string",          "minLength": 1        },        "code": {          "type": "string"        },        "nextFolioProduction": {          "$ref": "#/definitions/__schema0"        },        "nextFolioDevelopment": {          "$ref": "#/definitions/__schema0"        },        "status": {          "type": "string",          "enum": [            "active",            "inactive"          ]        },        "updatedAt": {          "type": "string",          "format": "date-time"        }      },      "required": [        "seriesId",        "code",        "nextFolioProduction",        "nextFolioDevelopment",        "status",        "updatedAt"      ],      "additionalProperties": false    },    "error": {      "$schema": "http://json-schema.org/draft-07/schema#",      "type": "object",      "properties": {        "code": {          "type": "string",          "enum": [            "validation_error",            "unauthenticated",            "forbidden",            "not_found",            "method_not_allowed",            "conflict",            "idempotency_conflict",            "operation_in_progress",            "recovery_required",            "rate_limited",            "provider_unavailable",            "internal"          ]        },        "message": {          "type": "string"        },        "details": {          "type": "object",          "properties": {            "issues": {              "type": "array",              "items": {                "type": "object",                "properties": {                  "path": {                    "type": "array",                    "items": {                      "anyOf": [                        {                          "type": "string"                        },                        {                          "type": "number"                        }                      ]                    }                  },                  "message": {                    "type": "string"                  },                  "code": {                    "type": "string"                  }                },                "required": [                  "path",                  "message"                ],                "additionalProperties": false              }            },            "retryable": {              "type": "boolean"            },            "retryAfterSeconds": {              "type": "integer",              "exclusiveMinimum": 0,              "maximum": 9007199254740991            }          },          "additionalProperties": false        }      },      "required": [        "code",        "message"      ],      "additionalProperties": false    }  },  "$schema": "http://json-schema.org/draft-07/schema#",  "additionalProperties": false,  "definitions": {    "__schema0": {      "type": "integer",      "minimum": 1,      "maximum": 9007199254740991    }  },  "oneOf": [    {      "required": [        "data"      ]    },    {      "required": [        "error"      ]    }  ]}

Related workflow

See the canonical workflows in the introduction

Related tools

Read fiscal series

Get the organization fiscal series and their development and production counters.

Get CFDI summary

Summarize CFDI activity for a month range: recognized income, recognized expenses, payroll paid, payroll received, balance, and top contributors. Every payroll contributor has a paid or received direction. Uses CFDI aggregates only. It excludes receipt/POS sales and is never a source for taxes paid or owed.