> ## Documentation Index > Fetch the complete documentation index at: https://docs.emify.co/llms.txt > Use this file to discover all available pages before exploring further. # Setear el próximo folio a usar > Fija el próximo folio a usar para un tipo de documento. El `next_folio_number` debe caer dentro del rango de algún CAF efectivamente cargado (un CAF activo donde `enumeration_from <= N <= enumeration_end`); si queda fuera de todos los rangos o en un hueco entre CAF no contiguos, responde `400 ENUMERATION_OUT_OF_RANGE` y no se redirige. Marca como usados todos los folios menores al número enviado a lo largo de todos los CAF activos de ese tipo de documento. El folio que efectivamente se usará (`next_number_to_use`) puede ser mayor que el número enviado cuando ese folio pertenece a un CAF cargado pero ya está usado o anulado, en cuyo caso resuelve al siguiente disponible dentro de los rangos cargados. La operación es global por tipo de documento, no por CAF individual. ## OpenAPI ````yaml /api-reference/openapi.json put /api/companies/{idCompany}/enumeration/document-type/{document_type_id}/next-folio openapi: 3.1.0 info: title: Emify API description: >- API pública de Emify para la emisión y gestión de documentos tributarios electrónicos (DTE) en Chile. version: 1.0.0 contact: name: Soporte Emify email: soporte@emify.co servers: - url: https://api.emify.co description: Producción - url: http://localhost:8080 description: Desarrollo local security: [] tags: - name: Certificates description: Gestión de certificados digitales por empresa - name: Legal Entities description: Tipos de persona jurídica / persona natural por país - name: Tax Identification Documents description: Documentos de identificación tributaria por país - name: Purchases (Receptions) description: Gestión de documentos recibidos (compras y recepciones) - name: Legal Activities description: Actividades económicas / giros por país - name: Tax Information description: Información fiscal de referencia por país - name: Additional Export Info description: Información adicional para documentos de exportación por país - name: Enumeration (CAF) description: Gestión de folios (CAF) y enumeración de documentos por empresa - name: Currencies description: Monedas disponibles por país - name: Document Cancellation Reasons description: Razones de anulación de documentos por país - name: Document Types description: Tipos de documentos tributarios por país - name: Companies description: Gestión de empresas emisoras de documentos tributarios - name: Measurement Units description: Unidades de medida por país - name: Users description: Operaciones de usuario autenticado - name: Company Settings description: Configuración operacional de la empresa - name: Item Code Types description: Tipos de código de ítem por país - name: Invoices description: Emisión y gestión de facturas y documentos tributarios electrónicos - name: Countries description: Listado de países soportados - name: Tax Types description: Tipos de impuesto por país - name: Taxpayers description: Consulta de datos de contribuyentes en entes tributarios - name: Webhooks description: Suscripción a eventos de la empresa vía webhooks - name: Payment Types description: Tipos de pago por país paths: /api/companies/{idCompany}/enumeration/document-type/{document_type_id}/next-folio: put: tags: - Enumeration (CAF) summary: Setear el próximo folio a usar description: >- Fija el próximo folio a usar para un tipo de documento. El `next_folio_number` debe caer dentro del rango de algún CAF efectivamente cargado (un CAF activo donde `enumeration_from <= N <= enumeration_end`); si queda fuera de todos los rangos o en un hueco entre CAF no contiguos, responde `400 ENUMERATION_OUT_OF_RANGE` y no se redirige. Marca como usados todos los folios menores al número enviado a lo largo de todos los CAF activos de ese tipo de documento. El folio que efectivamente se usará (`next_number_to_use`) puede ser mayor que el número enviado cuando ese folio pertenece a un CAF cargado pero ya está usado o anulado, en cuyo caso resuelve al siguiente disponible dentro de los rangos cargados. La operación es global por tipo de documento, no por CAF individual. operationId: setNextFolio parameters: - name: apiKey in: query required: true schema: $ref: '#/components/schemas/AuthenticatedApiKey' - name: idCompany in: path description: ID de la empresa required: true schema: type: string - name: document_type_id in: path description: >- ID del tipo de documento (`id_document_type`). Se obtiene de `GET /api/companies/{idCompany}/enumeration/list`. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SetNextFolioRequest' required: true responses: '200': description: Próximo folio actualizado content: application/json: schema: $ref: '#/components/schemas/SetNextFolioResponse' '400': description: >- El número enviado no cae dentro del rango de ningún CAF cargado —queda fuera de todos los rangos o en un hueco entre CAF no contiguos— (`ENUMERATION_OUT_OF_RANGE`, no se redirige) o cae dentro de un rango cargado pero no hay folios disponibles mayores o iguales a ese número (`ENUMERATION_NO_FOLIOS_AVAILABLE_FROM`, no se modifica nada). '401': description: API key inválida o ausente '403': description: Sin acceso a esta empresa '404': description: >- El tipo de documento no tiene enumeraciones activas (`ENUMERATION_NOT_FOUND`) security: - ApiKey: [] components: schemas: AuthenticatedApiKey: type: object properties: apiKeyId: type: string clientId: type: string role: type: string enum: - OWNER - ADMIN - MEMBER accessibleCompanyIds: type: array items: type: string SetNextFolioRequest: type: object properties: next_folio_number: type: integer format: int32 minimum: 1 description: >- Número de folio a partir del cual continuar. Debe caer dentro del rango de algún CAF efectivamente cargado. Emify marca como usados todos los folios menores a este número. example: 61 required: - next_folio_number SetNextFolioResponse: type: object properties: id_document_type: type: string description: ID del tipo de documento afectado example: '33' folios_updated: type: integer format: int32 description: Cantidad de folios que se marcaron como usados example: 58 next_number_to_use: type: integer format: int32 description: >- Próximo folio que efectivamente se usará. Puede ser mayor que el número enviado cuando ese folio pertenece a un CAF cargado pero ya está usado o anulado (resuelve al siguiente disponible dentro de los rangos cargados). example: 61 message: type: string description: Mensaje de confirmación example: Next folio updated successfully securitySchemes: ApiKey: type: apiKey name: X-Api-Key in: header ````