{
	"openapi": "3.0.0",
	"servers": [
		{
			"url": "https://app.facturadirecta.com/api"
		}
	],
	"info": {
		"version": "1.0.10",
		"title": "FacturaDirecta 2 API Pública",
		"contact": {
			"name": "Soporte API",
			"email": "info@facturadirecta.com",
			"url": "https://www.facturadirecta.com/ayuda/"
		},
		"description": "Software de facturación y contabilidad en la nube. Visita [FacturaDirecta](https://app.facturadirecta.com) para crear una cuenta.\n\nLa documentación completa de la API (guías, referencia de cada recurso, webhooks y ejemplos) está en [www.facturadirecta.com/desarrolladores/api](https://www.facturadirecta.com/desarrolladores/api/). Puedes probar las operaciones desde el [explorador de la API](https://www.facturadirecta.com/desarrolladores/api/explorador/).\n\n## Inicio rápido\n\n1. Crea una cuenta gratuita de [FacturaDirecta](https://app.facturadirecta.com).\n1. Localiza tu **companyId**.\n\n    Accede a la página de \"Ajustes > API e integraciones\" y al inicio de la página verás el \"Identificador de tu empresa en la API\" o `companyId`.\n\n    Necesitarás este `companyId` en la mayoría de las llamadas a la API: es el primer segmento de la ruta (`/{companyId}/...`).\n\n    NOTA: Si te identificas mediante OAuth2, con las credenciales que obtengas puedes tener acceso a más de una empresa (a todas las que pueda acceder el usuario que se identifica) y podrás ver el `companyId` de cada una de ellas mediante la llamada `/profile`. Esta llamada no está disponible con API key, ya que cada clave solo concede acceso a una única empresa y no está vinculada con ningún usuario.\n\n1. Elige cómo autorizarte (ver \"Autorización\" más abajo y la [guía de autenticación](https://www.facturadirecta.com/desarrolladores/api/guias/authentication/)):\n\n    * **API key**: crea una clave en \"Ajustes > API e integraciones\" con los scopes que necesites y envíala en la cabecera `facturadirecta-api-key`. Es la opción más directa cuando tu integración trabaja con una sola empresa.\n    * **OAuth2**: completa el flujo `Authorization code` con PKCE indicando `facturadirecta-api` como `client_id` (sin `client_secret`) y envía el token obtenido en la cabecera `Authorization: Bearer <token>`. Es la opción adecuada cuando tu aplicación actúa en nombre de un usuario de FacturaDirecta.\n\n1. Haz tu primera llamada.\n\n    Con OAuth2, `GET /profile` devuelve el usuario y las empresas a las que tiene acceso, con el `companyId` de cada una:\n\n    ```\n    curl undefined/api/profile \\\n      -H \"Authorization: Bearer $ACCESS_TOKEN\"\n    ```\n\n    Con una API key, `GET /{companyId}/apiKeyInfo` devuelve los scopes de la clave:\n\n    ```\n    curl undefined/api/$COMPANY_ID/apiKeyInfo \\\n      -H \"facturadirecta-api-key: $API_KEY\"\n    ```\n\n1. ¡Hecho! Con el `companyId` y tus credenciales ya puedes llamar al resto de operaciones.\n\n## Autorización\n\nLa API de FacturaDirecta te permite identificarte de dos formas diferentes.\n\n* Mediante \"Api-Key\": Utilizarás una clave de acceso que únicamente permite hacer llamadas a la API en la empresa para la que la creas y con los permisos que asignes\n* Mediante OAuth2: Utilizarás los permisos asociados a un usuario real con el que podrás operar en todas las empresas a las que tenga acceso con una combinación de los permisos que asignes en el momento de la autorización y los del propio usuario (se aplicarán los más restrictivos)\n\nLas dos opciones son igual de seguras, la elección de una u otra dependerá de tus preferencias o incluso del tipo de integración que quieres hacer.\n\n### Autorización mediante Api-Key\n\nPara utilizar este método de autorización tienes que acceder a la página de \"Ajustes > API e integraciones\" y crear una nueva clave de API en la página.\n\nUna vez tengas la clave de API añade la cabecera `facturadirecta-api-key: <your_api_key>` en tus llamadas a la API.\n\nA tener en cuenta con este sistema de identificación:\n\n* El acceso se controla únicamente por los niveles de acceso concedidos a la clave creada\n* Cada clave de API generada da acceso únicamente a la empresa en la que se ha creado\n* No interviene ningún usuario real en la identificación (no se puede ver afectado por tanto porque se elimine su acceso)\n\n### Autorización mediante OAuth\n\nFacturaDirecta utiliza el estándar OAuth2 de autorización con un flujo de tipo `Authorization code flow` para obtener el token necesario para autorizar las llamadas a la API.\n\nPara obtener este token únicamente tendrás que indicar el valor `facturadirecta-api` para `client_id`. No es necesario indicar ningún secreto en el campo `client_secret`.\n\n**PKCE es obligatorio.** El flujo `Authorization code` debe completarse con PKCE ([RFC 7636](https://datatracker.ietf.org/doc/html/rfc7636)) usando `S256` como método del challenge. En la práctica son tres pasos:\n\n1. Antes de redirigir al usuario a `/auth`, genera un `code_verifier` aleatorio (cadena de 43–128 caracteres del alfabeto `[A-Z][a-z][0-9]-._~`) y guárdalo en sesión.\n2. Calcula el `code_challenge` como `BASE64URL(SHA256(code_verifier))` y añade a la URL de autorización los parámetros `code_challenge=<valor>` y `code_challenge_method=S256`.\n3. En el intercambio del `code` por el `access_token` (`POST /token`), envía el `code_verifier` original como parámetro adicional del body.\n\nLas peticiones que no incluyan los parámetros PKCE serán rechazadas con un error `invalid_request`.\n\nConsulta la [documentación de OAuth](https://www.oauth.com/oauth2-servers/access-tokens/authorization-code-request/) para más información.\n\nUna vez identificado añade la cabecera `Authorization: Bearer <your_token>` en tus llamadas a la API.\n\nA tener en cuenta con este sistema de identificación:\n\n* Las credenciales obtenidas están ligadas a un usuario real del programa y por tanto conceden acceso a todas las empresas a las que este tiene acceso.\n* El acceso se controla tanto por los niveles de acceso concedidos en el momento de hacer la identificación como por los permisos del usuario real utilizado para la identificación (se aplica el más restrictivo)\n* Si se elimina el usuario del programa o de una empresa se elimina el acceso mediante la API\n\n## Versiones\n\nLa versión a consumir de la API se debe indicar con la cabecera `Accept-version`, en caso de no indicarse una versión se accederá a la última disponible. Los cambios en la API se intentarán hacer siempre compatibles hacia atrás y en caso de que no sea posible habrá un cambio en el número de versión mayor y/o menor.\n\nVersión actual: `1.0.10`\n"
	},
	"tags": [
		{
			"name": "Facturas de venta",
			"description": "Facturas que emite la empresa a sus clientes, incluidas las rectificativas y las sustitutivas, con sus cobros, su envío por correo, su PDF, su fichero Facturae y sus adjuntos."
		},
		{
			"name": "Facturas de venta recurrentes",
			"description": "Plantillas de factura programadas: en cada fecha configurada generan automáticamente una factura de venta."
		},
		{
			"name": "Presupuestos",
			"description": "Propuestas económicas que se envían a un cliente antes de emitir la factura."
		},
		{
			"name": "Pedidos",
			"description": "Encargos en firme de clientes, antes de su entrega y facturación. Cada línea tiene su propio estado."
		},
		{
			"name": "Albaranes",
			"description": "Justificantes de la entrega de bienes o servicios a un cliente, normalmente previos a la factura."
		},
		{
			"name": "Facturas de compra y tickets",
			"description": "Gastos de la empresa: facturas recibidas de proveedores y tickets de caja, con sus pagos y sus adjuntos."
		},
		{
			"name": "Órdenes de compra",
			"description": "Encargos en firme a proveedores, antes de recibir la mercancía y su factura. Cada línea tiene su propio estado."
		},
		{
			"name": "Bandeja de entrada",
			"description": "Documentos externos (PDF de facturas de proveedor, tickets escaneados, ficheros Facturae) que se convierten en gastos, tickets o nóminas con los datos leídos del documento."
		},
		{
			"name": "Uploads",
			"description": "Subida de archivos temporales para vincularlos después como adjuntos de documentos o como contenido de la bandeja de entrada."
		},
		{
			"name": "Contactos",
			"description": "Clientes, proveedores y empleados de la empresa. Un mismo contacto puede ser cliente, proveedor y empleado a la vez."
		},
		{
			"name": "Productos",
			"description": "Conceptos facturables preconfigurados que se reutilizan en las líneas de los documentos, con su stock y sus movimientos de stock."
		},
		{
			"name": "Campos personalizados",
			"description": "Definiciones de los campos adicionales que la empresa añade a sus documentos y contactos."
		},
		{
			"name": "Bancos",
			"description": "Cuentas de tesorería de la empresa: cuentas corrientes, tarjetas y cajas de efectivo."
		},
		{
			"name": "Extractos bancarios",
			"description": "Movimientos de las cuentas bancarias sincronizadas y su conciliación con asientos contables."
		},
		{
			"name": "Métodos de pago",
			"description": "Cómo se cobra o se paga un documento: una descripción manual o un instrumento SEPA (transferencia, domiciliación) con datos bancarios."
		},
		{
			"name": "Contabilidad",
			"description": "Consulta del diario contable: los apuntes que generan los documentos y los asientos de la empresa."
		},
		{
			"name": "Informes",
			"description": "Las mismas cifras que los informes de la web, ya calculadas y de solo lectura: resultados, pérdidas y ganancias, balance de situación y sumas y saldos."
		},
		{
			"name": "Declaraciones de impuestos",
			"description": "Modelos de impuestos que la empresa ha generado y guardado en FacturaDirecta, con sus casillas, su PDF y su fichero para la AEAT."
		},
		{
			"name": "Nóminas",
			"description": "Documentos contables de la retribución mensual de los empleados, con sus pagos y sus adjuntos."
		},
		{
			"name": "Búsqueda",
			"description": "Búsqueda global: localiza en una sola llamada contactos y documentos de la empresa a partir de un texto."
		},
		{
			"name": "Consultas",
			"description": "Consulta analítica: agrega los datos de la empresa eligiendo una fuente, las medidas que se suman y las dimensiones por las que se agrupan."
		},
		{
			"name": "Actividad",
			"description": "Historial de lo que pasa en la empresa: altas, modificaciones y eliminaciones de documentos, envíos y otros cambios."
		},
		{
			"name": "Usuario",
			"description": "Usuario identificado con OAuth2 y empresas a las que tiene acceso, con el `companyId` de cada una. No está disponible con API key."
		},
		{
			"name": "Ajustes",
			"description": "Catálogos de configuración de la empresa, de solo lectura: impuestos de venta y de compra, series de numeración y plantillas de documento."
		},
		{
			"name": "API Keys",
			"description": "Claves de acceso a la API, cada una limitada a una empresa, y consulta de los scopes de la clave con la que se hace la llamada."
		},
		{
			"name": "Webhooks",
			"description": "Endpoints que reciben en tiempo real los eventos de la empresa, e historial de entregas de esos eventos con su reintento."
		}
	],
	"paths": {
		"/profile": {
			"get": {
				"tags": [
					"Usuario"
				],
				"summary": "Perfil de usuario",
				"description": "Devuelve información de las empresas a las que se tiene acceso con las credenciales utilizadas en la identificación",
				"operationId": "getProfile",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					}
				],
				"responses": {
					"200": {
						"description": "Información del usuario",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "ProfileResponse",
									"required": [
										"profile"
									],
									"additionalProperties": false,
									"properties": {
										"profile": {
											"$ref": "#/components/schemas/ProfileUser"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": []
					}
				]
			}
		},
		"/{companyId}/contacts": {
			"get": {
				"tags": [
					"Contactos"
				],
				"summary": "Lista de contactos",
				"description": "Devuelve una lista de contactos",
				"operationId": "getContacts",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "country",
						"in": "query",
						"description": "País de la dirección fiscal del contacto (Formato ISO 3166-1 Alpha-2)",
						"schema": {
							"type": "string",
							"minLength": 2,
							"maxLength": 2
						}
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada por nombre (incluyendo apellidos y \"mostrar cómo\"/\"nombre comercial\"), email y NIF",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "fiscalId",
						"in": "query",
						"description": "NIF o identificador fiscal del contacto",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "vatEU",
						"in": "query",
						"description": "OBSOLETO: Usar fiscalId para buscar por identificador fiscal.\n\nNúmero de IVA intracomunitario del contacto. Se mantiene por compatibilidad.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "externalId",
						"in": "query",
						"description": "ID externo del contacto",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "phone",
						"in": "query",
						"description": "Teléfono del contacto. Búsqueda parcial, sin distinción entre mayúsculas/minúsculas ni acentos.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "isClient",
						"in": "query",
						"description": "Contacto con rol de cliente",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "isProvider",
						"in": "query",
						"description": "Contacto con rol de proveedor",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "isEmployee",
						"in": "query",
						"description": "Contacto con rol de empleado",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener el contacto para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener el contacto para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo contactos que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma ascendente por el código de país y descendente por fecha de creación utiliza los parámetros 'sortBy=country&sortBy=-creationDate'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* title: Campo \"Mostrar cómo\" o \"Nombre comercial\"\n* country: Código del país\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"title",
									"-title",
									"country",
									"-country",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con el contacto, se pueden indicar tantos valores como sea necesario entre los siguientes:\n  \n* receivePaymentMethod: Devuelve en related.objects el objeto que representa el método de cobro por defecto de este contacto (usado en clientes)\n* sendPaymentMethod: Devuelve en related.objects el objeto que representa el método de pago por defecto de este contacto (usado en proveedores)\n* paymentMethods: Devuelve en related.paymentMethods lista de los ids de todos los métodos de cobro/pago asociados a este cliente y cada uno de ellos en related.objects",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"receivePaymentMethod",
									"sendPaymentMethod",
									"paymentMethods"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de contactos",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetContactsResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/ContactResponse"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"contacts:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Contactos"
				],
				"summary": "Crear contacto",
				"description": "Crea un nuevo contacto",
				"operationId": "createContact",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del contacto a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateContactRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/ContactWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									}
								}
							},
							"examples": {
								"clientSpainCompany": {
									"summary": "Ejemplo de un cliente español (empresa)",
									"value": {
										"content": {
											"type": "contact",
											"main": {
												"name": "Cliente Empresa SL",
												"fiscalId": "B12345674",
												"currency": "EUR",
												"country": "ES",
												"address": "Pza Mayor, 4",
												"zipcode": "49004",
												"city": "Zamora",
												"accounts": {
													"client": "430000",
													"clientCredit": "438000"
												}
											}
										}
									}
								},
								"clientSpainIndividual": {
									"summary": "Ejemplo de un cliente final español",
									"value": {
										"content": {
											"type": "contact",
											"main": {
												"name": "Pedro",
												"surname": "García Gómez",
												"fiscalId": "82931482Z",
												"currency": "EUR",
												"country": "ES",
												"address": "Av. de Leopoldo Alas Clarín, 2",
												"zipcode": "49018",
												"city": "Zamora",
												"endCustomer": true,
												"accounts": {
													"client": "430000",
													"clientCredit": "438000"
												}
											}
										}
									}
								},
								"clientEU": {
									"summary": "Ejemplo de un cliente intracomunitario",
									"description": "Se debe indicar el identificador fiscal en fiscalId y el tipo fiscalIdType=\"02\" (NIF-IVA intracomunitario).\n\nPara que el programa pueda tratar este contacto como intracomunitario y aplicar los impuestos automáticamente debe indicarse también que el NIF ha sido validado mediante el elemento vatEUValidation.",
									"value": {
										"content": {
											"type": "contact",
											"main": {
												"name": "Google Ireland Limited",
												"fiscalId": "IE6388047V",
												"fiscalIdType": "02",
												"vatEUValidation": {
													"valid": true,
													"date": "2018-10-01T21:34:20+02:00"
												},
												"currency": "EUR",
												"country": "IE",
												"address": "Gordon House, Barrow Street",
												"city": "Dublin 4",
												"accounts": {
													"client": "430000",
													"clientCredit": "438000"
												}
											}
										}
									}
								},
								"clientOtherCountry": {
									"summary": "Ejemplo de un cliente extracomunitario y con moneda distinta de EUR",
									"description": "Se recomienda usar los campos estructurados (address, zipcode, city, region) para la dirección.\n\nSe puede indicar el identificador fiscal del país de origen en fiscalId con fiscalIdType=\"06\" (otro documento probatorio).",
									"value": {
										"content": {
											"type": "contact",
											"main": {
												"name": "Mailgun Technologies",
												"fiscalId": "12-3456789",
												"fiscalIdType": "06",
												"currency": "USD",
												"country": "US",
												"address": "535 Mission St., 14th Floor",
												"zipcode": "94105",
												"city": "San Francisco",
												"region": "CA",
												"accounts": {
													"client": "430000",
													"clientCredit": "438000"
												}
											}
										}
									}
								},
								"clientEULegacy": {
									"summary": "OBSOLETO: Cliente intracomunitario con vatEU y fullAddress",
									"description": "Este ejemplo muestra el formato legacy que sigue funcionando por compatibilidad.\n\nPara nuevos contactos, usar el formato con fiscalId, fiscalIdType y campos estructurados de dirección (ver ejemplo clientEU).",
									"value": {
										"content": {
											"type": "contact",
											"main": {
												"name": "Google Ireland Limited",
												"vatEU": "IE6388047V",
												"vatEUValidation": {
													"valid": true,
													"date": "2018-10-01T21:34:20+02:00"
												},
												"currency": "EUR",
												"country": "IE",
												"fullAddress": "Gordon House\nBarrow Street\nDublin 4\nIreland",
												"accounts": {
													"client": "430000",
													"clientCredit": "438000"
												}
											}
										}
									}
								},
								"clientOtherCountryLegacy": {
									"summary": "OBSOLETO: Cliente extracomunitario con fullAddress",
									"description": "Este ejemplo muestra el formato legacy con fullAddress que sigue funcionando por compatibilidad.\n\nPara nuevos contactos, usar el formato con campos estructurados de dirección (ver ejemplo clientOtherCountry).",
									"value": {
										"content": {
											"type": "contact",
											"main": {
												"name": "Mailgun Technologies",
												"currency": "USD",
												"country": "US",
												"fullAddress": "535 Mission St., 14th Floor\nSan Francisco, CA 94105",
												"accounts": {
													"client": "430000",
													"clientCredit": "438000"
												}
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación del contacto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateContactResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Contact"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"contacts:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/contacts/{id}": {
			"get": {
				"tags": [
					"Contactos"
				],
				"summary": "Obtener un contacto",
				"description": "Obtiene el contenido de un contacto",
				"operationId": "getContact",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del contacto. Formado por el prefjo \"con_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con el contacto, se pueden indicar tantos valores como sea necesario entre los siguientes:\n  \n* receivePaymentMethod: Devuelve en related.objects el objeto que representa el método de cobro por defecto de este contacto (usado en clientes)\n* sendPaymentMethod: Devuelve en related.objects el objeto que representa el método de pago por defecto de este contacto (usado en proveedores)\n* paymentMethods: Devuelve en related.paymentMethods lista de los ids de todos los métodos de cobro/pago asociados a este cliente y cada uno de ellos en related.objects",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"receivePaymentMethod",
									"sendPaymentMethod",
									"paymentMethods"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido del contacto solicitado",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ContactResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"contacts:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Contactos"
				],
				"summary": "Actualizar contacto",
				"description": "Actualiza un contacto existente",
				"operationId": "updateContact",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del contacto. Formado por el prefjo \"con_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del contacto a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateContactRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/ContactWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización del contacto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateContactResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Contact"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"contacts:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Contactos"
				],
				"summary": "Borrar contacto",
				"description": "Elimina un contacto existente",
				"operationId": "deleteContact",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del contacto. Formado por el prefjo \"con_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"contacts:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/contacts/{id}/tags": {
			"put": {
				"tags": [
					"Contactos"
				],
				"summary": "Actualizar etiquetas de contacto",
				"description": "Actualiza las etiquetas de un contacto existente",
				"operationId": "updateContactTags",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del contacto. Formado por el prefjo \"con_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de las etiquetas a modificar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateContactTagsRequest",
								"required": [
									"tags",
									"tagsOperation"
								],
								"properties": {
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de las etiquetas del contacto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateContactTagsResponse",
									"required": [
										"tags"
									],
									"properties": {
										"tags": {
											"$ref": "#/components/schemas/Tags"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"contacts:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/products": {
			"get": {
				"tags": [
					"Productos"
				],
				"summary": "Lista de productos",
				"description": "Devuelve una lista de productos",
				"operationId": "getProducts",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada en el título, la referencia y las descripciones del producto: todas las palabras, sin distinguir acentos ni mayúsculas. Es la búsqueda rápida del listado de la aplicación.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "title",
						"in": "query",
						"description": "Búsqueda aproximada por nombre",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sku",
						"in": "query",
						"description": "Código de producto (SKU)",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "externalId",
						"in": "query",
						"description": "ID externo del producto",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "isSales",
						"in": "query",
						"description": "Producto de venta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "salesDescription",
						"in": "query",
						"description": "Búsqueda aproximada por descripción de venta",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "isPurchases",
						"in": "query",
						"description": "Producto de compra",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "purchasesDescription",
						"in": "query",
						"description": "Búsqueda aproximada por descripción de compra",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "isDepreciable",
						"in": "query",
						"description": "Bien de inversión",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma ascendente por el código de producto y descendente por el nombre utiliza los parámetros 'sortBy=sku&sortBy=-title'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* title: Nombre del producto\n* sku: Código de producto\n* salesDescription: Descripción para la venta del producto\n* purchasesDescription: Descripción para la compra del producto\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"title",
									"-title",
									"sku",
									"-sku",
									"salesDescription",
									"-salesDescription",
									"purchasesDescription",
									"-purchasesDescription",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					}
				],
				"responses": {
					"200": {
						"description": "Lista de productos",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetProductsResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"type": "object",
												"title": "Item",
												"required": [
													"content",
													"creationDate",
													"modificationDate"
												],
												"additionalProperties": false,
												"properties": {
													"content": {
														"$ref": "#/components/schemas/Product"
													},
													"creationDate": {
														"$ref": "#/components/schemas/CreationDate"
													},
													"modificationDate": {
														"$ref": "#/components/schemas/ModificationDate"
													},
													"webUrl": {
														"$ref": "#/components/schemas/WebUrl"
													}
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Productos"
				],
				"summary": "Crear producto",
				"description": "Crea un nuevo producto",
				"operationId": "createProduct",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del producto a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateProductRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/ProductWrite"
									}
								}
							},
							"examples": {
								"sales": {
									"summary": "Producto de venta",
									"value": {
										"content": {
											"type": "product",
											"main": {
												"sku": "PV001",
												"name": "Producto 001",
												"currency": "EUR",
												"sales": {
													"price": 125,
													"description": "Descripción del producto 001 que aparecerá en los documentos cuando se seleccione",
													"tax": [
														"S_IVA_21"
													],
													"account": "700000"
												}
											}
										}
									}
								},
								"purchases": {
									"summary": "Producto de compra",
									"value": {
										"content": {
											"type": "product",
											"main": {
												"sku": "PC001",
												"name": "Producto comprado 001",
												"currency": "EUR",
												"purchases": {
													"price": 125,
													"description": "Descripción del producto de compra 001 que aparecerá en los documentos cuando se seleccione",
													"tax": [
														"P_IVA_21_BC"
													],
													"account": "600000"
												}
											}
										}
									}
								},
								"salesAndPurchases": {
									"summary": "Producto de compra y venta",
									"value": {
										"content": {
											"type": "product",
											"main": {
												"sku": "PCV009",
												"name": "Producto 009",
												"currency": "EUR",
												"sales": {
													"price": 125,
													"description": "Descripción del producto en los documentos de venta",
													"tax": [
														"S_IVA_21"
													],
													"account": "700000"
												},
												"purchases": {
													"price": 75,
													"description": "Descripción del producto en los documentos de compra",
													"tax": [
														"P_IVA_21_BC"
													],
													"account": "600000"
												}
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación del producto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateProductResponse",
									"required": [
										"content",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Product"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/products/{id}": {
			"get": {
				"tags": [
					"Productos"
				],
				"summary": "Obtener un producto",
				"description": "Obtiene el contenido de un producto",
				"operationId": "getProduct",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del product. Formado por el prefjo \"pro_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido del producto solicitado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetProductResponse",
									"required": [
										"content",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Product"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Productos"
				],
				"summary": "Actualizar producto",
				"description": "Actualiza un producto existente",
				"operationId": "updateProduct",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del product. Formado por el prefjo \"pro_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del producto a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateProductRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/ProductWrite"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización del producto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateProductResponse",
									"required": [
										"content",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Product"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Productos"
				],
				"summary": "Borrar producto",
				"description": "Elimina un producto existente",
				"operationId": "deleteProduct",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del product. Formado por el prefjo \"pro_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/products/{id}/stock": {
			"get": {
				"tags": [
					"Productos"
				],
				"summary": "Stock de un producto",
				"description": "Magnitudes de stock del producto: `physical` (existencias físicas, suma del libro de movimientos), `committed` (comprometido en pedidos de cliente activos), `incoming` (previsto en órdenes de compra pendientes de recibir), `available` (físico − comprometido) y `projected` (disponible + previsto). Requiere que el producto tenga el control de stock activado (`main.stock.enabled`) y que el plan incluya la función de control de stock.",
				"operationId": "getProductStock",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del product. Formado por el prefjo \"pro_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Magnitudes de stock del producto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetProductStockPublicResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/ProductStockInfo"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/products/{id}/stockMovements": {
			"get": {
				"tags": [
					"Productos"
				],
				"summary": "Movimientos de stock de un producto",
				"description": "Libro de movimientos de stock (kardex) del producto, de más reciente a más antiguo, con el saldo tras cada movimiento. Requiere control de stock activado en el producto.",
				"operationId": "listProductStockMovements",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del product. Formado por el prefjo \"pro_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					}
				],
				"responses": {
					"200": {
						"description": "Página del kardex del producto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetProductStockMovementsPublicResponse",
									"additionalProperties": false,
									"required": [
										"pagination",
										"items"
									],
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/PublicStockMovement"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/products/{id}/stockAdjustments": {
			"post": {
				"tags": [
					"Productos"
				],
				"summary": "Ajuste manual de stock",
				"description": "Registra un ajuste manual del stock físico del producto con motivo tipado. El ajuste queda como un movimiento más del libro (kardex). Requiere control de stock activado en el producto.",
				"operationId": "adjustProductStock",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del product. Formado por el prefjo \"pro_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"quantity",
									"reason"
								],
								"properties": {
									"quantity": {
										"type": "number",
										"description": "Cantidad firmada del ajuste (+entrada / −salida). No puede ser cero."
									},
									"reason": {
										"type": "string",
										"enum": [
											"merma",
											"rotura",
											"robo",
											"caducidad",
											"consumo_propio",
											"muestra_regalo",
											"correccion"
										],
										"description": "Motivo tipado del ajuste"
									},
									"note": {
										"type": "string",
										"description": "Nota opcional"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado del ajuste",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateStockAdjustmentPublicResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"type": "object",
											"title": "StockAdjustmentResult",
											"additionalProperties": false,
											"required": [
												"id",
												"quantity",
												"physical"
											],
											"properties": {
												"id": {
													"type": "string",
													"description": "ID del movimiento creado"
												},
												"quantity": {
													"type": "number"
												},
												"physical": {
													"type": "number",
													"description": "Stock físico tras el ajuste"
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices": {
			"get": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Lista de facturas",
				"description": "Devuelve una lista de facturas",
				"operationId": "getInvoices",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada en el texto del documento (título, líneas, notas) y en el nombre de su contacto: todas las palabras, sin distinguir acentos ni mayúsculas. Es la búsqueda rápida del listado de la aplicación.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima de la factura en formato YYYY-MM-DD.\n\nSe incluirán en los resultados facturas con fecha mayor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima de la factura en formato YYYY-MM-DD.\n\nSe incluirán en los resultados facturas con fecha menor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "series",
						"in": "query",
						"description": "Serie de la factura sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "formattedSeries",
						"in": "query",
						"description": "Serie de la factura",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minNumber",
						"in": "query",
						"description": "Número secuencial mínimo de la factura.\n            \nSe incluirán en los resultados facturas con número secuencial mayor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "maxNumber",
						"in": "query",
						"description": "Número secuencial máximo de la factura.\n            \nSe incluirán en los resultados facturas con número secuencial menor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "state",
						"in": "query",
						"description": "Estados de factura a incluir. Cada factura tiene un único estado en cada momento; estos valores son excluyentes entre sí. Si se indican varios, se incluyen las facturas cuyo estado sea cualquiera de ellos.\n\n* draft: Borrador o factura provisional; no genera asientos contables\n* pending: Factura definitiva con saldo pendiente que aún no ha vencido\n* overdue: Factura definitiva con saldo pendiente vencido según sus vencimientos\n* paid: Factura definitiva con saldo pendiente cero\n* overpaid: Factura definitiva cuyos cobros superan el importe esperado\n* voided: Factura anulada",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"draft",
									"pending",
									"overdue",
									"paid",
									"overpaid",
									"voided"
								]
							}
						}
					},
					{
						"name": "contact",
						"in": "query",
						"description": "Cliente de la factura",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasContact",
						"in": "query",
						"description": "Factura con contacto, utiliza el valor 'false' para obtener las facturas simplificadas",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "minTotal",
						"in": "query",
						"description": "Importe total mínimo de la factura",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "maxTotal",
						"in": "query",
						"description": "Importe total máximo de la factura",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "currency",
						"in": "query",
						"description": "Moneda de la factura (Formato ISO 4217)",
						"schema": {
							"type": "string",
							"minLength": 3,
							"maxLength": 3
						}
					},
					{
						"name": "totals",
						"in": "query",
						"description": "Con `true`, añade `totals` a la respuesta: el recuento y la suma de la base imponible, los impuestos, el total y el importe pendiente de todas las facturas que cumplen los filtros (no solo de la página), con una fila por moneda. Es la forma de responder «¿cuánto suman?» sin paginar.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "draft",
						"in": "query",
						"description": "Comportamiento de las facturas provisionales. Si no se indica nada se incluirán solo las facturas definitivas. Los borradores no generan asientos contables; cuando se incluyen, el recuento del listado puede no coincidir con el diario.\n\n* only: Se incluirán solo las facturas provisionales\n* all: Se incluirán todas las facturas (definitivas y provisionales)",
						"schema": {
							"type": "string",
							"enum": [
								"only",
								"all"
							]
						}
					},
					{
						"name": "country",
						"in": "query",
						"description": "País de la dirección de facturación (Formato ISO 3166-1 Alpha-2)",
						"schema": {
							"type": "string",
							"minLength": 2,
							"maxLength": 2
						}
					},
					{
						"name": "emails",
						"in": "query",
						"description": "Búsqueda parcial en los emails del documento (campo main.emails).\n\nLa búsqueda no es por coincidencia exacta, sino que realiza una búsqueda parcial insensible a mayúsculas/minúsculas y acentos. Cada palabra del valor proporcionado se busca de forma independiente y deben coincidir todas (operador AND).\n\nPor ejemplo, si el valor de emails del documento es `\"cliente@empresa.com, admin@empresa.com\"`:\n* `emails=empresa.com` → coincide (búsqueda parcial)\n* `emails=cliente@empresa` → coincide\n* `emails=cliente admin` → coincide (ambas palabras están presentes)\n* `emails=otro@dominio.com` → no coincide",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener la factura para ser incluida en los resultados.\n      \nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener la factura para ser incluida en los resultados.\n      \nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo facturas que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por fecha y luego por moneda utiliza los parámetros 'sortBy=-date&sortBy=currency'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* date: Fecha de factura\n* series: Serie de la factura sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)\n* formattedSeries: Serie de la factura\n* number: Número secuencial mínimo de la factura \n* total: Importe total de la factura\n* currency: Moneda de la factura\n* country: País de la dirección fiscal de la factura\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date",
									"series",
									"-series",
									"formattedSeries",
									"-formattedSeries",
									"number",
									"-number",
									"total",
									"-total",
									"currency",
									"-currency",
									"country",
									"-country",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la factura, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en la factura\n* balance: Devuelve en related.balance detalle del saldo pendiente de la factura\n* state: Devuelve en related.state el estado de la factura (draft, pending, overdue, paid, overpaid, voided)\n* journal: Devuelve en related.journal los apuntes contables que afectan al saldo de la factura (mismo shape que `GET /journal?document={id}`, incluyendo `tra_` asientos contables y `pay_` remesas SEPA)",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds",
									"balance",
									"state",
									"journal"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de facturas",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetInvoicesResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/InvoiceResponse"
											}
										},
										"totals": {
											"type": "array",
											"description": "Solo con `totals=true`: totales del conjunto filtrado completo, una fila por moneda",
											"items": {
												"type": "object",
												"title": "ListTotals",
												"additionalProperties": false,
												"required": [
													"currency",
													"count",
													"total",
													"totalBeforeTaxes",
													"taxes",
													"pending",
													"companyCurrencyPending"
												],
												"properties": {
													"currency": {
														"type": "string",
														"nullable": true,
														"description": "Moneda de los documentos de la fila"
													},
													"count": {
														"type": "integer",
														"description": "Documentos que cumplen los filtros"
													},
													"total": {
														"type": "number",
														"description": "Suma del total, impuestos incluidos, en la moneda de la fila"
													},
													"totalBeforeTaxes": {
														"type": "number",
														"description": "Suma de la base imponible, en la moneda de la fila"
													},
													"taxes": {
														"type": "number",
														"description": "Suma de los impuestos: `total` menos `totalBeforeTaxes`"
													},
													"pending": {
														"type": "number",
														"description": "Importe pendiente de cobro, en positivo, en la moneda de la fila; negativo si se ha cobrado de más"
													},
													"companyCurrencyPending": {
														"type": "number",
														"description": "Importe pendiente de cobro en la moneda de la empresa"
													}
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Crear factura",
				"description": "Crea una nueva factura. Si no se indica main.draft, nace provisional o definitiva según la configuración de la empresa (sales.newInvoiceMode); indícalo siempre de forma explícita. Crearla como definitiva equivale a emitirla: se le asigna número y, con VeriFactu o TicketBAI activos, se genera el registro fiscal y se envía a la administración en ese momento, y ya no se puede modificar ni borrar, solo anular o rectificar.",
				"operationId": "createInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la factura a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateInvoiceRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/InvoiceWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"payments": {
										"$ref": "#/components/schemas/InvoicePaymentsWrite"
									}
								}
							},
							"examples": {
								"minimal": {
									"summary": "Contenido mínimo para crear una factura",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Descripción del servicio"
													}
												]
											}
										}
									}
								},
								"installments": {
									"summary": "Factura con varios vencimientos",
									"description": "Cada elemento de `installments` define un cobro previsto con fecha, importe y moneda. Los vencimientos pendientes se pueden seleccionar por separado al preparar una remesa SEPA de recibos domiciliados. `dueDate` se ajusta automáticamente a la fecha del último vencimiento.",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"installments": [
													{
														"date": "2026-07-15",
														"amount": 60.5,
														"currency": "EUR"
													},
													{
														"date": "2026-08-15",
														"amount": 60.5,
														"currency": "EUR"
													}
												],
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Descripción del servicio"
													}
												]
											}
										}
									}
								},
								"autoTaxes": {
									"summary": "Factura sin especificar `tax` (resolución automática)",
									"description": "Cuando `tax` se omite, FacturaDirecta usa los impuestos del producto (si la línea referencia uno en `document`) o los impuestos por defecto de la empresa (`settings.taxes.sales`) y aplica la posición fiscal del contacto. Para indicar explícitamente que la línea no lleva impuestos, enviar `tax: []`.",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"text": "Línea sin tax: se aplican los impuestos por defecto de la empresa"
													}
												]
											}
										}
									}
								},
								"taxes": {
									"summary": "Factura con varios impuestos",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Producto IVA 21%"
													},
													{
														"quantity": 1,
														"unitPrice": 50,
														"tax": [
															"S_IVA_10"
														],
														"text": "Producto IVA 10%"
													},
													{
														"quantity": 1,
														"unitPrice": 20,
														"tax": [
															"S_IVA_4"
														],
														"text": "Producto IVA 4%"
													}
												]
											}
										}
									}
								},
								"irpf": {
									"summary": "Factura con IRPF",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21",
															"S_IRPF_15"
														],
														"text": "Servicios profesionales"
													}
												]
											}
										}
									}
								},
								"accounting": {
									"summary": "Factura contabilizada en distintas cuentas",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Producto estándar",
														"account": "700000"
													},
													{
														"quantity": 1,
														"unitPrice": 250,
														"tax": [
															"S_IVA_21"
														],
														"text": "Producto especial contabilizado en la cuenta 700001",
														"account": "700001"
													}
												]
											}
										}
									}
								},
								"suplidos": {
									"summary": "Factura con suplidos",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Servicios profesionales"
													},
													{
														"quantity": 1,
														"unitPrice": 50,
														"tax": [
															"S_SUPLIDOS"
														],
														"text": "Suplidos Registro Mercantil",
														"document": "pro_suplido",
														"account": "566000"
													}
												]
											}
										}
									}
								},
								"taxIncludedPrices": {
									"summary": "Factura con precios con impuestos incluidos",
									"description": "Con este ejemplo se crea una factura para la venta de 2 productos de 100€ (IVA incluido) y se desglosará correctamente el IVA para que el importe total de la factura sea de 200€",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"taxIncludedPrices": true,
												"currency": "EUR",
												"lines": [
													{
														"quantity": 2,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Producto PVP 100€"
													}
												]
											}
										}
									}
								},
								"paidInvoice": {
									"summary": "Factura pagada",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Descripción del servicio"
													}
												]
											}
										},
										"payments": [
											{
												"bank": "ban_10000000-0000-4000-8000-000000000000"
											}
										]
									}
								},
								"paidInvoice2": {
									"summary": "Factura con varios pagos",
									"description": "Con este ejemplo se crea una factura con fecha 2022-05-01 de importe 100 + 21% de IVA (Total 121€) y se generan dos pagos de 50€ (forzando el importe) con fechas 2022-04-15 y 2022-04-25 y otro por el importe pendiente en la misma fecha de factura (cuando no se indica la fecha en el propio pago este se crea con la fecha de factura)",
									"value": {
										"content": {
											"type": "invoice",
											"main": {
												"docNumber": {
													"series": "F"
												},
												"date": "2022-05-01",
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Descripción del servicio"
													}
												]
											}
										},
										"payments": [
											{
												"date": "2022-04-15",
												"bank": "ban_10000000-0000-4000-8000-000000000000",
												"amount": 50
											},
											{
												"date": "2022-04-25",
												"bank": "ban_10000000-0000-4000-8000-000000000000",
												"amount": 50
											},
											{
												"bank": "ban_10000000-0000-4000-8000-000000000000"
											}
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación de la factura",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateInvoiceResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Invoice"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/substitution": {
			"post": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Crear factura sustitutiva de simplificadas",
				"description": "Crea una factura sustitutiva (F3 en VeriFactu) que consolida varias facturas simplificadas en una única factura completa con un cliente identificado fiscalmente.\n\nEl servidor se encarga de:\n* Copiar las líneas de las facturas simplificadas\n* Validar la consistencia de moneda e impuestos\n* Añadir la nota estándar de sustitución\n* Asignar el tipo F3 para VeriFactu\n\nLas facturas simplificadas indicadas deben cumplir:\n* Ser facturas simplificadas (sin identificación completa del destinatario)\n* No ser facturas externas\n* No estar ya incluidas en otra factura sustitutiva\n* Tener la misma moneda y el mismo valor de taxIncludedPrices",
				"operationId": "createSubstitutionInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Datos para crear la factura sustitutiva",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateSubstitutionInvoiceRequest",
								"required": [
									"contact",
									"substitutedInvoices"
								],
								"additionalProperties": false,
								"properties": {
									"contact": {
										"type": "string",
										"description": "UUID del contacto con identificación fiscal (con_...)"
									},
									"substitutedInvoices": {
										"type": "array",
										"minItems": 1,
										"items": {
											"type": "string"
										},
										"description": "UUIDs de las facturas simplificadas a sustituir (inv_...)"
									},
									"docNumber": {
										"$ref": "#/components/schemas/DocNumberWrite"
									},
									"date": {
										"type": "string",
										"format": "date",
										"description": "Fecha de la factura sustitutiva en formato YYYY-MM-DD. Si no se indica se usa la fecha actual"
									},
									"notes": {
										"type": "string",
										"description": "Notas adicionales. La nota estándar de sustitución se añade siempre automáticamente"
									},
									"internalNotes": {
										"type": "string",
										"description": "Notas internas, no serán visibles en el documento impreso"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									}
								}
							},
							"examples": {
								"basic": {
									"summary": "Crear factura sustitutiva básica",
									"value": {
										"contact": "con_10000000-0000-4000-8000-000000000000",
										"substitutedInvoices": [
											"inv_20000000-0000-4000-8000-000000000001",
											"inv_20000000-0000-4000-8000-000000000002"
										]
									}
								},
								"withOptions": {
									"summary": "Crear factura sustitutiva con opciones",
									"value": {
										"contact": "con_10000000-0000-4000-8000-000000000000",
										"substitutedInvoices": [
											"inv_20000000-0000-4000-8000-000000000003"
										],
										"docNumber": {
											"series": "FS"
										},
										"date": "2025-01-15",
										"notes": "Sustitución solicitada por el cliente",
										"tags": [
											"sustitutiva"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación de la factura sustitutiva",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateSubstitutionInvoiceResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Invoice"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}": {
			"get": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Obtener una factura",
				"description": "Obtiene el contenido de una factura",
				"operationId": "getInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la factura, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en la factura\n* balance: Devuelve en related.balance detalle del saldo pendiente de la factura\n* state: Devuelve en related.state el estado de la factura (draft, pending, overdue, paid, overpaid, voided)\n* journal: Devuelve en related.journal los apuntes contables que afectan al saldo de la factura (mismo shape que `GET /journal?document={id}`, incluyendo `tra_` asientos contables y `pay_` remesas SEPA)",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds",
									"balance",
									"state",
									"journal"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido de la factura solicitada",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/InvoiceResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Actualizar factura",
				"description": "Actualiza una factura existente. Sustituye el contenido del documento: las líneas se reemplazan por las enviadas y los campos opcionales que no se envían se eliminan. Los campos obligatorios que no se envían conservan su valor, y el número de documento y los metadatos no cambian. Pasar main.draft a false emite la factura y pasar main.voided a true la anula; con VeriFactu o TicketBAI activos, las dos operaciones generan registros que se envían a la administración y no se pueden revertir. Una factura ya emitida con VeriFactu solo admite los cambios subsanables (ver verifactuOperation) y con TicketBAI no admite cambios en su contenido.",
				"operationId": "updateInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la factura a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateInvoiceRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/InvoiceWrite"
									},
									"syncContactData": {
										"description": "Cuando se indica true, sincroniza automáticamente la dirección (address, country, zipcode) y los datos fiscales de la contraparte (counterpart) a partir del contacto indicado en main.contact. Si main.contact es null, elimina la dirección y la contraparte del documento. No modifica los emails, la posición fiscal, la fecha de vencimiento ni la cuenta contable",
										"type": "boolean"
									},
									"verifactuOperation": {
										"type": "object",
										"additionalProperties": false,
										"properties": {
											"subsanacion": {
												"description": "Selecciona esta opción para indicar que estás intentando guardar una factura con una subsanación de VeriFactu. Solo puede usarse con facturas que ya contengan información previa de VeriFactu",
												"type": "boolean",
												"enum": [
													true
												]
											}
										}
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de la factura",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateInvoiceResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Invoice"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Borrar factura",
				"description": "Elimina una factura existente",
				"operationId": "deleteInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}/payments": {
			"post": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Crear pagos para una factura",
				"description": "Crear pagos para una factura\n\nLa respuesta es la factura completa actualizada (`InvoicePaymentsWriteResponse`, mismo shape que crear o consultar la factura).\n\nPara obtener directamente en la respuesta los apuntes contables que componen el saldo (incluyendo el recién creado), pasa `related=journal` en el body. Cada apunte trae `id` polimórfico (`tra_<uuid-v4>` para asientos contables directos, `pay_<uuid-v4>` para remesas SEPA), `account`, `debit`, `credit`, `date` y campos de multicurrency cuando aplica. Útil para encadenar el cobro recién registrado con `PUT /{companyId}/statements/{id}/reconciliation` sin un round-trip extra.\n\nAlternativa: `GET /{companyId}/journal?document={id}&related=idAccounting` devuelve los mismos apuntes con más detalle (incluyendo el asiento del propio documento, su `idAccounting` completo y opcionalmente `tags`).",
				"operationId": "createInvoicePayments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de los pagos a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateInvoicePaymentsRequest",
								"required": [
									"payments"
								],
								"properties": {
									"payments": {
										"$ref": "#/components/schemas/InvoicePaymentsWrite"
									},
									"related": {
										"type": "array",
										"items": {
											"type": "string",
											"enum": [
												"taxIds",
												"balance",
												"state",
												"journal"
											]
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación de pagos en la factura. Se devuelve la factura completa igual que en la operación de consulta de la misma",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/InvoicePaymentsWriteResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}/tags": {
			"put": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Actualizar etiquetas de factura",
				"description": "Actualiza las etiquetas de una factura existente",
				"operationId": "updateInvoiceTags",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de las etiquetas a modificar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateInvoiceTagsRequest",
								"required": [
									"tags",
									"tagsOperation"
								],
								"properties": {
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de las etiquetas de la factura",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateInvoiceTagsResponse",
									"required": [
										"tags"
									],
									"properties": {
										"tags": {
											"$ref": "#/components/schemas/Tags"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}/send": {
			"put": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Enviar factura por correo electrónico",
				"description": "Envía la factura por correo electrónico con destinatarios, título y contenido obtenidos de su plantilla o bien valores personalizados indicados en la llamada",
				"operationId": "sendInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/SendInvoiceRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/SendInvoiceResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}/pdf": {
			"put": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Generar la factura en formato PDF",
				"description": "Solicita la generación del documento en formato PDF. Se devuelve una URL temporal desde la que poder descargar el documento en formato PDF\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que solo genera un fichero temporal, así que se puede repetir sin riesgo.",
				"operationId": "createInvoicePDF",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/CreateDocumentPDFRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/GetDocumentPDFResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}/facturae": {
			"put": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Generar la factura en formato facturae",
				"description": "Solicita la generación del documento en formato facturae.\n        \nSe devuelve una URL desde la que poder descargar el documento en formato facturae.\n\nEl documento en formato facturae se generará en el momento solo si aún no ha sido generado o si ha habido cambios en el documento original desde la última vez que se creó en el formato indicado.\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que solo genera un fichero temporal, así que se puede repetir sin riesgo.",
				"operationId": "createInvoiceFacturae",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateInvoiceFacturaeRequest",
								"required": [
									"version"
								],
								"properties": {
									"version": {
										"type": "string",
										"enum": [
											"3.2.1"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la petición de obtención de la factura en formato facturae",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateInvoiceFacturaeResponse",
									"required": [
										"url",
										"filename"
									],
									"additionalProperties": false,
									"properties": {
										"url": {
											"type": "string",
											"description": "URL desde la que descargar o visualizar el archivo solicitado."
										},
										"filename": {
											"type": "string",
											"description": "Nombre del archivo facturae generado. Este nombre es el que enviará el servidor a través de la cabecera Content-Disposition si se intenta descargar el documento."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}/attachments": {
			"post": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Vincular adjuntos a una factura",
				"description": "Vincula uno o varios uploads previamente creados con `POST /api/{companyId}/uploads` a una factura existente, sin necesidad de reenviar el documento completo.\n\nLos uploads pasan a estado `consumed` y los archivos quedan persistidos en S3 bajo el prefijo de la empresa. Si la factura ya tiene adjuntos, los nuevos se añaden a los existentes (no los sustituyen).\n\nUn documento puede tener un máximo de **10** adjuntos.",
				"operationId": "addInvoiceAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "AddInvoiceAttachmentsRequest",
								"additionalProperties": false,
								"required": [
									"uploadIds"
								],
								"properties": {
									"uploadIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"minItems": 1,
										"description": "Lista de identificadores de upload (`upl_<uuid>`) creados con POST /api/{companyId}/uploads."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Vincular dos adjuntos",
									"value": {
										"uploadIds": [
											"upl_8a2c1234-1234-1234-1234-123456789012",
											"upl_5f9b1234-1234-1234-1234-123456789012"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Factura con los nuevos adjuntos vinculados",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/InvoiceResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"get": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Listar adjuntos de una factura de venta",
				"operationId": "getInvoiceAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de adjuntos de una factura de venta",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "getInvoiceAttachmentsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Attachment"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}/attachments/{attachmentIndex}": {
			"delete": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Eliminar adjunto de una factura de venta",
				"description": "Elimina el adjunto en la posición indicada. Los índices son 0-based. El binario en S3 no se elimina para preservar URLs ya distribuidas.",
				"operationId": "deleteInvoiceAttachment",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "attachmentIndex",
						"in": "path",
						"required": true,
						"schema": {
							"type": "integer",
							"minimum": 0
						},
						"description": "Índice (0-based) del adjunto a eliminar."
					}
				],
				"responses": {
					"200": {
						"description": "Adjunto eliminado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "deleteInvoiceAttachmentResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/recurring/invoices": {
			"get": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Lista de facturas de venta recurrentes",
				"description": "Devuelve una lista de facturas de venta recurrentes",
				"operationId": "getRecurringInvoices",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada en el texto de la factura recurrente (título, líneas, notas) y en el nombre de su contacto: todas las palabras, sin distinguir acentos ni mayúsculas. Es la búsqueda rápida del listado de la aplicación.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minNextScheduledDate",
						"in": "query",
						"required": false,
						"description": "Fecha y hora mínima de la próxima ejecución de la factura (`nextScheduledTime`), incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta desde el inicio de ese día en la zona horaria de la empresa.",
						"allowReserved": true,
						"schema": {
							"type": "string",
							"anyOf": [
								{
									"type": "string",
									"format": "date"
								},
								{
									"type": "string",
									"format": "date-time"
								}
							]
						}
					},
					{
						"name": "maxNextScheduledDate",
						"in": "query",
						"required": false,
						"description": "Fecha y hora máxima de la próxima ejecución de la factura (`nextScheduledTime`), incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta hasta el final de ese día en la zona horaria de la empresa.",
						"allowReserved": true,
						"schema": {
							"type": "string",
							"anyOf": [
								{
									"type": "string",
									"format": "date"
								},
								{
									"type": "string",
									"format": "date-time"
								}
							]
						}
					},
					{
						"name": "series",
						"in": "query",
						"description": "Serie de la factura recurrente sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "enabled",
						"in": "query",
						"description": "Indica si la factura recurrente está activa.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "freq",
						"in": "query",
						"description": "Unidad de la frecuencia de ejecución",
						"schema": {
							"type": "string",
							"enum": [
								"yearly",
								"monthly",
								"weekly",
								"daily"
							]
						}
					},
					{
						"name": "interval",
						"in": "query",
						"description": "Número de días/semanas/meses/años entre ejecuciones",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					},
					{
						"name": "contact",
						"in": "query",
						"description": "Cliente de la factura recurrente",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasContact",
						"in": "query",
						"description": "Factura recurrente con contacto, utiliza el valor 'false' para obtener facturas recurrentes sin contacto asociado",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "minTotal",
						"in": "query",
						"description": "Importe total mínimo de la factura recurrente",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "maxTotal",
						"in": "query",
						"description": "Importe total máximo de la factura recurrente",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "currency",
						"in": "query",
						"description": "Moneda de la factura recurrente (Formato ISO 4217)",
						"schema": {
							"type": "string",
							"minLength": 3,
							"maxLength": 3
						}
					},
					{
						"name": "country",
						"in": "query",
						"description": "País de la dirección de facturación (Formato ISO 3166-1 Alpha-2)",
						"schema": {
							"type": "string",
							"minLength": 2,
							"maxLength": 2
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener la factura recurrente para ser incluida en los resultados.\n      \nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener la factura recurrente para ser incluida en los resultados.\n      \nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo facturas recurrentes que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por fecha y luego por moneda utiliza los parámetros 'sortBy=-series&sortBy=currency'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* nextScheduledTime: Fecha programada de próxima ejecución\n* series: Serie de la factura recurrente sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)\n* total: Importe total de la factura recurrente\n* currency: Moneda de la factura recurrente\n* country: País de la dirección fiscal de la factura recurrente\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"nextScheduledTime",
									"-nextScheduledTime",
									"series",
									"-series",
									"total",
									"-total",
									"currency",
									"-currency",
									"country",
									"-country",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la factura recurrente, se pueden indicar tantos valores como sea necesario entre los siguientes:\n  \n* nextScheduledTime: Devuelve la fecha y hora prevista de próxima ejecución de la factura recurrente\n* upcomingSceheduledTimes: Devuelve un máximo de las próximas 5 fechas de ejecución programadas de la factura\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en la factura recurrente",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds",
									"nextScheduledTime",
									"upcomingSceheduledTimes"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de facturas de venta recurrentes",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetRecurringInvoicesResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/RecurringInvoiceResponse"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:read",
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Crea factura de venta recurrente",
				"description": "Crea una nueva factura de venta recurrente",
				"operationId": "createRecurringInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la factura recurrente a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateRecurringInvoiceRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/RecurringInvoiceWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									}
								}
							},
							"examples": {
								"minimal": {
									"summary": "Contenido mínimo para crear una factura de venta recurrente",
									"description": "Ejemplo para crear una factura recurrente que se ejecutará anual que se ejecutará 2 años a partir del año 2040 los días 10 de enero",
									"value": {
										"content": {
											"type": "automation",
											"main": {
												"title": "Ejemplo factura recurrente",
												"enabled": true,
												"trigger": {
													"type": "recurring",
													"rrule": {
														"interval": 1,
														"freq": "yearly",
														"bymonthday": 10,
														"bymonth": 1,
														"dtstart": "2040-01-01T06:00:00.000Z",
														"until": "2042-01-02T06:00:00.000Z"
													}
												},
												"action": {
													"type": "createDocument",
													"template": {
														"type": "invoice",
														"main": {
															"docNumber": {
																"series": "FP"
															},
															"contact": "con_10000000-0000-4000-8000-000000000000",
															"currency": "EUR",
															"lines": [
																{
																	"quantity": 1,
																	"unitPrice": 100,
																	"tax": [
																		"S_IVA_21"
																	],
																	"text": "Descripción del servicio"
																}
															]
														}
													}
												}
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación del presupuesto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateRecurringInvoiceResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/RecurringInvoice"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:write",
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/recurring/invoices/{id}": {
			"get": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Obtener una factura de venta recurrente",
				"description": "Obtiene el contenido de una factura de venta recurrente",
				"operationId": "getRecurringInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura recurrente. Formado por el prefjo \"aut_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la factura recurrente, se pueden indicar tantos valores como sea necesario entre los siguientes:\n  \n* nextScheduledTime: Devuelve la fecha y hora prevista de próxima ejecución de la factura recurrente\n* upcomingSceheduledTimes: Devuelve un máximo de las próximas 5 fechas de ejecución programadas de la factura\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en la factura recurrente",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds",
									"nextScheduledTime",
									"upcomingSceheduledTimes"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido de la factura recurrente solicitada",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/RecurringInvoiceResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:read",
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Actualizar factura recurrente",
				"description": "Actualiza una factura recurrente existente. Sustituye el contenido del documento: las líneas se reemplazan por las enviadas y los campos opcionales que no se envían se eliminan. Los campos obligatorios que no se envían conservan su valor, y el número de documento y los metadatos no cambian.",
				"operationId": "updateRecurringInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura recurrente. Formado por el prefjo \"aut_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la factura recurrente a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateRecurringInvoiceRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/RecurringInvoiceWrite"
									},
									"syncContactData": {
										"description": "Cuando se indica true, sincroniza automáticamente la dirección (address, country, zipcode) y los datos fiscales de la contraparte (counterpart) a partir del contacto indicado en main.contact. Si main.contact es null, elimina la dirección y la contraparte del documento. No modifica los emails, la posición fiscal, la fecha de vencimiento ni la cuenta contable",
										"type": "boolean"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de la factura recurrente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateRecurringInvoiceResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/RecurringInvoice"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:write",
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Borrar factura de venta recurrente",
				"description": "Elimina una factura de venta recurrente",
				"operationId": "deleteRecurringInvoice",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura recurrente. Formado por el prefjo \"aut_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:write",
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/recurring/invoices/{id}/tags": {
			"put": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Actualizar etiquetas de factura de venta recurrente",
				"description": "Actualiza las etiquetas de una factura de venta recurrente existente",
				"operationId": "updateRecurringInvoiceTags",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura recurrente. Formado por el prefjo \"aut_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de las etiquetas a modificar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateRecurringInvoiceTagsRequest",
								"required": [
									"tags",
									"tagsOperation"
								],
								"properties": {
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de las etiquetas de la factura recurrente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateRecurringInvoiceTagsResponse",
									"required": [
										"tags"
									],
									"properties": {
										"tags": {
											"$ref": "#/components/schemas/Tags"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:write",
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/recurring/invoices/{id}/pdf": {
			"put": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Generar muestra de la factura de venta recurrente en formato PDF",
				"description": "Solicita la generación de una muestra del documento recurrente en formato PDF. Se devuelve una URL temporal desde la que poder descargar el documento en formato PDF\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que solo genera un fichero temporal, así que se puede repetir sin riesgo.",
				"operationId": "createRecurringInvoicePDF",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura recurrente. Formado por el prefjo \"aut_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/CreateDocumentPDFRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/GetDocumentPDFResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:read",
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/recurring/invoices/{id}/attachments": {
			"post": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Vincular adjuntos a una factura recurrente",
				"description": "Vincula uno o varios uploads a la plantilla de una factura recurrente. Los adjuntos se aplicarán a las facturas generadas en cada ejecución.\n\nMáximo **10** adjuntos por documento.",
				"operationId": "addRecurringInvoiceAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura recurrente. Formado por el prefjo \"aut_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "AddRecurringInvoiceAttachmentsRequest",
								"additionalProperties": false,
								"required": [
									"uploadIds"
								],
								"properties": {
									"uploadIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"minItems": 1,
										"description": "Lista de identificadores de upload (`upl_<uuid>`) creados con POST /api/{companyId}/uploads."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Vincular un adjunto",
									"value": {
										"uploadIds": [
											"upl_8a2c1234-1234-1234-1234-123456789012"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Factura recurrente con los nuevos adjuntos vinculados a su plantilla",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/RecurringInvoiceResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:write",
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"get": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Listar adjuntos de una factura recurrente",
				"operationId": "getRecurringInvoiceAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura recurrente. Formado por el prefjo \"aut_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de adjuntos de una factura recurrente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "getRecurringInvoiceAttachmentsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Attachment"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:read"
						]
					},
					{
						"oAuth": [
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/recurring/invoices/{id}/attachments/{attachmentIndex}": {
			"delete": {
				"tags": [
					"Facturas de venta recurrentes"
				],
				"summary": "Eliminar adjunto de una factura recurrente",
				"description": "Elimina el adjunto en la posición indicada. Los índices son 0-based. El binario en S3 no se elimina para preservar URLs ya distribuidas.",
				"operationId": "deleteRecurringInvoiceAttachment",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura recurrente. Formado por el prefjo \"aut_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "attachmentIndex",
						"in": "path",
						"required": true,
						"schema": {
							"type": "integer",
							"minimum": 0
						},
						"description": "Índice (0-based) del adjunto a eliminar."
					}
				],
				"responses": {
					"200": {
						"description": "Adjunto eliminado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "deleteRecurringInvoiceAttachmentResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"recurring:write"
						]
					},
					{
						"oAuth": [
							"invoices:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/estimates": {
			"get": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Lista de presupuestos",
				"description": "Devuelve una lista de presupuestos",
				"operationId": "getEstimates",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada en el texto del documento (título, líneas, notas) y en el nombre de su contacto: todas las palabras, sin distinguir acentos ni mayúsculas. Es la búsqueda rápida del listado de la aplicación.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima del presupuesto en formato YYYY-MM-DD.\n\nSe incluirán en los resultados presupuestos con fecha mayor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima del presupuesto en formato YYYY-MM-DD.\n\nSe incluirán en los resultados presupuestos con fecha menor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "series",
						"in": "query",
						"description": "Serie del presupuesto sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "formattedSeries",
						"in": "query",
						"description": "Serie del presupuesto",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minNumber",
						"in": "query",
						"description": "Número secuencial mínimo del presupuesto\n            \nSe incluirán en los resultados presupuestos con número secuencial mayor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "maxNumber",
						"in": "query",
						"description": "Número secuencial máximo del presupuesto.\n            \nSe incluirán en los resultados presupuestos con número secuencial menor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "contact",
						"in": "query",
						"description": "Cliente del presupuesto",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasContact",
						"in": "query",
						"description": "Presupuesto con contacto, utiliza el valor 'false' para obtener presupuestos sin contacto asociado",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "minTotal",
						"in": "query",
						"description": "Importe total mínimo del presupuesto",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "maxTotal",
						"in": "query",
						"description": "Importe total máximo del presupuesto",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "currency",
						"in": "query",
						"description": "Moneda del presupuesto (Formato ISO 4217)",
						"schema": {
							"type": "string",
							"minLength": 3,
							"maxLength": 3
						}
					},
					{
						"name": "country",
						"in": "query",
						"description": "País de la dirección de facturación (Formato ISO 3166-1 Alpha-2)",
						"schema": {
							"type": "string",
							"minLength": 2,
							"maxLength": 2
						}
					},
					{
						"name": "emails",
						"in": "query",
						"description": "Búsqueda parcial en los emails del documento (campo main.emails).\n\nLa búsqueda no es por coincidencia exacta, sino que realiza una búsqueda parcial insensible a mayúsculas/minúsculas y acentos. Cada palabra del valor proporcionado se busca de forma independiente y deben coincidir todas (operador AND).\n\nPor ejemplo, si el valor de emails del documento es `\"cliente@empresa.com, admin@empresa.com\"`:\n* `emails=empresa.com` → coincide (búsqueda parcial)\n* `emails=cliente@empresa` → coincide\n* `emails=cliente admin` → coincide (ambas palabras están presentes)\n* `emails=otro@dominio.com` → no coincide",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener el presupuesto para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener el presupuesto para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo presupuestos que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por fecha y luego por moneda utiliza los parámetros 'sortBy=-date&sortBy=currency'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* date: Fecha de presupuesto\n* series: Serie del presupuesto sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)\n* formattedSeries: Serie del presupuesto\n* number: Número secuencial mínimo del presupuesto \n* total: Importe total del presupuesto\n* currency: Moneda del presupuesto\n* country: País de la dirección fiscal del presupuesto\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date",
									"series",
									"-series",
									"formattedSeries",
									"-formattedSeries",
									"number",
									"-number",
									"total",
									"-total",
									"currency",
									"-currency",
									"country",
									"-country",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con el presupuesto, se pueden indicar tantos valores como sea necesario entre los siguientes:\n  \n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en el presupuesto",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de presupuestos",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetEstimatesResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/EstimateResponse"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Crear presupuesto",
				"description": "Crea un nuevo presupuesto",
				"operationId": "createEstimate",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del presupuesto a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateEstimateRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/EstimateWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									}
								}
							},
							"examples": {
								"minimal": {
									"summary": "Contenido mínimo para crear un presupuesto",
									"value": {
										"content": {
											"type": "estimate",
											"main": {
												"docNumber": {
													"series": "P"
												},
												"baseState": "pending",
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Descripción del servicio"
													}
												]
											}
										}
									}
								},
								"autoTaxes": {
									"summary": "Presupuesto sin especificar `tax` (resolución automática)",
									"description": "Cuando `tax` se omite, FacturaDirecta usa los impuestos del producto (si la línea referencia uno en `document`) o los impuestos por defecto de la empresa (`settings.taxes.sales`) y aplica la posición fiscal del contacto. Para indicar explícitamente que la línea no lleva impuestos, enviar `tax: []`.",
									"value": {
										"content": {
											"type": "estimate",
											"main": {
												"docNumber": {
													"series": "P"
												},
												"baseState": "pending",
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"text": "Línea sin tax: se aplican los impuestos por defecto de la empresa"
													}
												]
											}
										}
									}
								},
								"onlyDescription": {
									"summary": "Sin cantidad ni importe unitario visibles",
									"description": "Ejemplo de creación de un presupuesto que únicamente muestra la descripción de cada línea y el precio total",
									"value": {
										"content": {
											"type": "estimate",
											"main": {
												"showProductColumn": false,
												"showQuantityColumn": false,
												"docNumber": {
													"series": "P"
												},
												"baseState": "pending",
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"lineTotal": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Descripción del servicio"
													}
												]
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación del presupuesto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateEstimateResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Estimate"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/estimates/{id}": {
			"get": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Obtener un presupuesto",
				"description": "Obtiene el contenido de un presupuesto",
				"operationId": "getEstimate",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del presupuesto. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con el presupuesto, se pueden indicar tantos valores como sea necesario entre los siguientes:\n  \n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en el presupuesto",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido del presupuesto solicitado",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/EstimateResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Actualizar presupuesto",
				"description": "Actualiza un presupuesto existente. Sustituye el contenido del documento: las líneas se reemplazan por las enviadas y los campos opcionales que no se envían se eliminan. Los campos obligatorios que no se envían conservan su valor, y el número de documento y los metadatos no cambian.",
				"operationId": "updateEstimate",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del presupuesto. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del presupuesto a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateEstimateRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/EstimateWrite"
									},
									"syncContactData": {
										"description": "Cuando se indica true, sincroniza automáticamente la dirección (address, country, zipcode) y los datos fiscales de la contraparte (counterpart) a partir del contacto indicado en main.contact. Si main.contact es null, elimina la dirección y la contraparte del documento. No modifica los emails, la posición fiscal, la fecha de vencimiento ni la cuenta contable",
										"type": "boolean"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización del presupuesto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateEstimateResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Estimate"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Borrar presupuesto",
				"description": "Elimina un presupuesto existente",
				"operationId": "deleteEstimate",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del presupuesto. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/estimates/{id}/tags": {
			"put": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Actualizar etiquetas de presupuesto",
				"description": "Actualiza las etiquetas de un presupuesto existente",
				"operationId": "updateEstimateTags",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del presupuesto. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de las etiquetas a modificar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateEstimateTagsRequest",
								"required": [
									"tags",
									"tagsOperation"
								],
								"properties": {
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de las etiquetas del presupuesto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateEstimateTagsResponse",
									"required": [
										"tags"
									],
									"properties": {
										"tags": {
											"$ref": "#/components/schemas/Tags"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/estimates/{id}/send": {
			"put": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Enviar presupuesto por correo electrónico",
				"description": "Envía el presupuesto por correo electrónico con destinatarios, título y contenido obtenidos de su plantilla o bien valores personalizados indicados en la llamada",
				"operationId": "sendEstimate",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del presupuesto. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/SendDocumentRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/SendDocumentResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/estimates/{id}/pdf": {
			"put": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Generar el presupuesto en formato PDF",
				"description": "Solicita la generación del documento en formato PDF. Se devuelve una URL temporal desde la que poder descargar el documento en formato PDF\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que solo genera un fichero temporal, así que se puede repetir sin riesgo.",
				"operationId": "createEstimatePDF",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del presupuesto. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/CreateDocumentPDFRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/GetDocumentPDFResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/estimates/{id}/attachments": {
			"post": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Vincular adjuntos a un presupuesto",
				"description": "Vincula uno o varios uploads previamente creados con `POST /api/{companyId}/uploads` a un presupuesto existente. Máximo **10** adjuntos por documento.",
				"operationId": "addEstimateAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del presupuesto. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "AddEstimateAttachmentsRequest",
								"additionalProperties": false,
								"required": [
									"uploadIds"
								],
								"properties": {
									"uploadIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"minItems": 1,
										"description": "Lista de identificadores de upload (`upl_<uuid>`) creados con POST /api/{companyId}/uploads."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Vincular un adjunto",
									"value": {
										"uploadIds": [
											"upl_8a2c1234-1234-1234-1234-123456789012"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Presupuesto con los nuevos adjuntos vinculados",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/EstimateResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"get": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Listar adjuntos de un presupuesto",
				"operationId": "getEstimateAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del presupuesto. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de adjuntos de un presupuesto",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "getEstimateAttachmentsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Attachment"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/estimates/{id}/attachments/{attachmentIndex}": {
			"delete": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Eliminar adjunto de un presupuesto",
				"description": "Elimina el adjunto en la posición indicada. Los índices son 0-based. El binario en S3 no se elimina para preservar URLs ya distribuidas.",
				"operationId": "deleteEstimateAttachment",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del presupuesto. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "attachmentIndex",
						"in": "path",
						"required": true,
						"schema": {
							"type": "integer",
							"minimum": 0
						},
						"description": "Índice (0-based) del adjunto a eliminar."
					}
				],
				"responses": {
					"200": {
						"description": "Adjunto eliminado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "deleteEstimateAttachmentResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/clientOrders": {
			"get": {
				"tags": [
					"Pedidos"
				],
				"summary": "Lista de pedidos",
				"description": "Devuelve una lista de pedidos de cliente.\n\nEl estado del pedido se calcula automáticamente a partir del estado de sus líneas y no se puede editar directamente. Los estados posibles son:\n\n* pending: Pendiente. Alguna línea está pendiente (`pending`) o pedida a proveedor (`ordered`)\n* ready: Listo para entregar. Ninguna línea está pendiente y al menos una está lista para entregar\n* delivered: Entregado. Todas las líneas activas están entregadas\n* canceled: Cancelado. Todas las líneas están canceladas\n\nPara cambiar el estado del pedido se cambian los estados de sus líneas (`lines[].state`).",
				"operationId": "getClientOrders",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada en el texto del documento (título, líneas, notas) y en el nombre de su contacto: todas las palabras, sin distinguir acentos ni mayúsculas. Es la búsqueda rápida del listado de la aplicación.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "state",
						"in": "query",
						"description": "Estado del pedido, se pueden indicar varios valores para incluir pedidos en cualquiera de los estados indicados.\n\nEl estado del pedido se calcula automáticamente a partir del estado de sus líneas y no se puede editar directamente. Los estados posibles son:\n\n* pending: Pendiente. Alguna línea está pendiente (`pending`) o pedida a proveedor (`ordered`)\n* ready: Listo para entregar. Ninguna línea está pendiente y al menos una está lista para entregar\n* delivered: Entregado. Todas las líneas activas están entregadas\n* canceled: Cancelado. Todas las líneas están canceladas\n\nPara cambiar el estado del pedido se cambian los estados de sus líneas (`lines[].state`).",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"pending",
									"ready",
									"delivered",
									"canceled"
								]
							}
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima del pedido en formato YYYY-MM-DD.\n\nSe incluirán en los resultados pedidos con fecha mayor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima del pedido en formato YYYY-MM-DD.\n\nSe incluirán en los resultados pedidos con fecha menor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "series",
						"in": "query",
						"description": "Serie del pedido sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "formattedSeries",
						"in": "query",
						"description": "Serie del pedido",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minNumber",
						"in": "query",
						"description": "Número secuencial mínimo del pedido\n\nSe incluirán en los resultados pedidos con número secuencial mayor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "maxNumber",
						"in": "query",
						"description": "Número secuencial máximo del pedido.\n\nSe incluirán en los resultados pedidos con número secuencial menor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "contact",
						"in": "query",
						"description": "Cliente del pedido",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasContact",
						"in": "query",
						"description": "Pedido con contacto, utiliza el valor 'false' para obtener pedidos sin contacto asociado",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "minTotal",
						"in": "query",
						"description": "Importe total mínimo del pedido",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "maxTotal",
						"in": "query",
						"description": "Importe total máximo del pedido",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "currency",
						"in": "query",
						"description": "Moneda del pedido (Formato ISO 4217)",
						"schema": {
							"type": "string",
							"minLength": 3,
							"maxLength": 3
						}
					},
					{
						"name": "country",
						"in": "query",
						"description": "País de la dirección de facturación (Formato ISO 3166-1 Alpha-2)",
						"schema": {
							"type": "string",
							"minLength": 2,
							"maxLength": 2
						}
					},
					{
						"name": "emails",
						"in": "query",
						"description": "Búsqueda parcial en los emails del documento (campo main.emails).\n\nLa búsqueda no es por coincidencia exacta, sino que realiza una búsqueda parcial insensible a mayúsculas/minúsculas y acentos. Cada palabra del valor proporcionado se busca de forma independiente y deben coincidir todas (operador AND).\n\nPor ejemplo, si el valor de emails del documento es `\"cliente@empresa.com, admin@empresa.com\"`:\n* `emails=empresa.com` → coincide (búsqueda parcial)\n* `emails=cliente@empresa` → coincide\n* `emails=cliente admin` → coincide (ambas palabras están presentes)\n* `emails=otro@dominio.com` → no coincide",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener el pedido para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener el pedido para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo pedidos que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por fecha y luego por moneda utiliza los parámetros 'sortBy=-date&sortBy=currency'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* date: Fecha del pedido\n* series: Serie del pedido sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)\n* formattedSeries: Serie del pedido\n* number: Número secuencial del pedido\n* total: Importe total del pedido\n* currency: Moneda del pedido\n* country: País de la dirección fiscal del pedido\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date",
									"series",
									"-series",
									"formattedSeries",
									"-formattedSeries",
									"number",
									"-number",
									"total",
									"-total",
									"currency",
									"-currency",
									"country",
									"-country",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con el pedido, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en el pedido",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de pedidos",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetClientOrdersResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/ClientOrderResponse"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Pedidos"
				],
				"summary": "Crear pedido",
				"description": "Crea un nuevo pedido de cliente.\n\nEl estado del pedido se calcula automáticamente a partir del estado de sus líneas y no se puede editar directamente. Los estados posibles son:\n\n* pending: Pendiente. Alguna línea está pendiente (`pending`) o pedida a proveedor (`ordered`)\n* ready: Listo para entregar. Ninguna línea está pendiente y al menos una está lista para entregar\n* delivered: Entregado. Todas las líneas activas están entregadas\n* canceled: Cancelado. Todas las líneas están canceladas\n\nPara cambiar el estado del pedido se cambian los estados de sus líneas (`lines[].state`).\n\nCada línea del pedido tiene su propio estado (`lines[].state`):\n\n* pending: Pendiente. La línea está pendiente de preparar\n* ordered: Pedida a proveedor. Lo gestiona FacturaDirecta cuando la línea está vinculada a una orden de compra\n* ready: Lista para entregar\n* delivered: Entregada al cliente\n* canceled: Cancelada\n\nSi una línea referencia un producto y asigna `provider`, el producto debe tener activadas sus preferencias de compra. Las líneas libres sin producto sí pueden tener proveedor. Los campos de vínculo `purchaseOrder` y `purchaseOrderLine` los gestiona FacturaDirecta y no pueden crearse o modificarse desde el pedido.\n\nSi una línea no indica `state` se crea como `pending`, y si no indica `id` FacturaDirecta le asigna uno nuevo.",
				"operationId": "createClientOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del pedido a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateClientOrderRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/ClientOrderWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									}
								}
							},
							"examples": {
								"minimal": {
									"summary": "Contenido mínimo para crear un pedido",
									"description": "Las líneas se crean en estado `pending`, por lo que el pedido queda en estado `pending`",
									"value": {
										"content": {
											"type": "clientOrder",
											"main": {
												"docNumber": {
													"series": "PED"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"S_IVA_21"
														],
														"text": "Descripción del artículo pedido"
													}
												]
											}
										}
									}
								},
								"conEstadosDeLinea": {
									"summary": "Pedido indicando el estado y el proveedor de las líneas",
									"description": "Cada línea puede indicar su `state` y el contacto `provider` que la suministrará. El estado del pedido se calcula a partir de los estados de las líneas: en este ejemplo todas están `ready`, por lo que el pedido queda en estado `ready`.",
									"value": {
										"content": {
											"type": "clientOrder",
											"main": {
												"docNumber": {
													"series": "PED"
												},
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 2,
														"unitPrice": 50,
														"tax": [
															"S_IVA_21"
														],
														"text": "Artículo en stock listo para entregar",
														"state": "ready"
													},
													{
														"quantity": 1,
														"unitPrice": 75,
														"tax": [
															"S_IVA_21"
														],
														"text": "Artículo suministrado por proveedor",
														"state": "ready",
														"provider": "con_10000000-0000-4000-8000-000000000000"
													}
												]
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación del pedido",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateClientOrderResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/ClientOrder"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/clientOrders/{id}": {
			"get": {
				"tags": [
					"Pedidos"
				],
				"summary": "Obtener un pedido",
				"description": "Obtiene el contenido de un pedido",
				"operationId": "getClientOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID del pedido. Formado por el prefijo \"cor_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con el pedido, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en el pedido",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido del pedido solicitado",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ClientOrderResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Pedidos"
				],
				"summary": "Actualizar pedido",
				"description": "Actualiza un pedido existente sustituyendo su contenido completo por el recibido.\n\n**Identidad de las líneas (`lines[].id`):** cada línea tiene un identificador estable dentro del pedido que ancla sus vínculos con otros documentos (por ejemplo con las líneas de una orden de compra). Al actualizar el pedido:\n\n* Las líneas que incluyan un `id` existente conservan su identidad y por tanto sus vínculos.\n* Las líneas sin `id` (o con un `id` nuevo) se tratan como líneas nuevas.\n\nPara modificar una línea conservando su identidad, envíala con el mismo `id` que devolvió la API al crear o consultar el pedido.\n\n**Estado del pedido:** `main.state` se recalcula siempre a partir de los estados de las líneas; si se envía se ignora. Para cambiar el estado del pedido cambia los `lines[].state` (por ejemplo, marcando todas las líneas como `delivered` el pedido pasa a `delivered`).\n\nCada línea del pedido tiene su propio estado (`lines[].state`):\n\n* pending: Pendiente. La línea está pendiente de preparar\n* ordered: Pedida a proveedor. Lo gestiona FacturaDirecta cuando la línea está vinculada a una orden de compra\n* ready: Lista para entregar\n* delivered: Entregada al cliente\n* canceled: Cancelada\n\nSustituye el contenido del documento: las líneas se reemplazan por las enviadas y los campos opcionales que no se envían se eliminan. Los campos obligatorios que no se envían conservan su valor, y el número de documento y los metadatos no cambian.",
				"operationId": "updateClientOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID del pedido. Formado por el prefijo \"cor_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del pedido a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateClientOrderRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/ClientOrderWrite"
									},
									"syncContactData": {
										"description": "Cuando se indica true, sincroniza automáticamente la dirección (address, country, zipcode) y los datos fiscales de la contraparte (counterpart) a partir del contacto indicado en main.contact. Si main.contact es null, elimina la dirección y la contraparte del documento. No modifica los emails, la posición fiscal, la fecha de vencimiento ni la cuenta contable",
										"type": "boolean"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización del pedido",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateClientOrderResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/ClientOrder"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Pedidos"
				],
				"summary": "Borrar pedido",
				"description": "Elimina un pedido existente",
				"operationId": "deleteClientOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID del pedido. Formado por el prefijo \"cor_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/clientOrders/{id}/tags": {
			"put": {
				"tags": [
					"Pedidos"
				],
				"summary": "Actualizar etiquetas de pedido",
				"description": "Actualiza las etiquetas de un pedido existente",
				"operationId": "updateClientOrderTags",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID del pedido. Formado por el prefijo \"cor_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de las etiquetas a modificar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateClientOrderTagsRequest",
								"required": [
									"tags",
									"tagsOperation"
								],
								"properties": {
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de las etiquetas del pedido",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateClientOrderTagsResponse",
									"required": [
										"tags"
									],
									"properties": {
										"tags": {
											"$ref": "#/components/schemas/Tags"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/clientOrders/{id}/send": {
			"put": {
				"tags": [
					"Pedidos"
				],
				"summary": "Enviar pedido por correo electrónico",
				"description": "Envía el pedido por correo electrónico con destinatarios, título y contenido obtenidos de su plantilla o bien valores personalizados indicados en la llamada",
				"operationId": "sendClientOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID del pedido. Formado por el prefijo \"cor_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/SendDocumentRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/SendDocumentResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/clientOrders/{id}/pdf": {
			"put": {
				"tags": [
					"Pedidos"
				],
				"summary": "Generar el pedido en formato PDF",
				"description": "Solicita la generación del documento en formato PDF. Se devuelve una URL temporal desde la que poder descargar el documento en formato PDF\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que solo genera un fichero temporal, así que se puede repetir sin riesgo.",
				"operationId": "createClientOrderPDF",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID del pedido. Formado por el prefijo \"cor_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/CreateDocumentPDFRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/GetDocumentPDFResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/clientOrders/{id}/attachments": {
			"post": {
				"tags": [
					"Pedidos"
				],
				"summary": "Vincular adjuntos a un pedido",
				"description": "Vincula uno o varios uploads previamente creados con `POST /api/{companyId}/uploads` a un pedido existente. Máximo **10** adjuntos por documento.",
				"operationId": "addClientOrderAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID del pedido. Formado por el prefijo \"cor_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "AddClientOrderAttachmentsRequest",
								"additionalProperties": false,
								"required": [
									"uploadIds"
								],
								"properties": {
									"uploadIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"minItems": 1,
										"description": "Lista de identificadores de upload (`upl_<uuid>`) creados con POST /api/{companyId}/uploads."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Vincular un adjunto",
									"value": {
										"uploadIds": [
											"upl_8a2c1234-1234-1234-1234-123456789012"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Pedido con los nuevos adjuntos vinculados",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ClientOrderResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"get": {
				"tags": [
					"Pedidos"
				],
				"summary": "Listar adjuntos de un pedido",
				"operationId": "getClientOrderAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID del pedido. Formado por el prefijo \"cor_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de adjuntos de un pedido",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "getClientOrderAttachmentsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Attachment"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/clientOrders/{id}/attachments/{attachmentIndex}": {
			"delete": {
				"tags": [
					"Pedidos"
				],
				"summary": "Eliminar adjunto de un pedido",
				"description": "Elimina el adjunto en la posición indicada. Los índices son 0-based. El binario en S3 no se elimina para preservar URLs ya distribuidas.",
				"operationId": "deleteClientOrderAttachment",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID del pedido. Formado por el prefijo \"cor_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "attachmentIndex",
						"in": "path",
						"required": true,
						"schema": {
							"type": "integer",
							"minimum": 0
						},
						"description": "Índice (0-based) del adjunto a eliminar."
					}
				],
				"responses": {
					"200": {
						"description": "Adjunto eliminado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "deleteClientOrderAttachmentResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/purchaseOrders": {
			"get": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Lista de órdenes de compra",
				"description": "Devuelve una lista de órdenes de compra.\n\nEl estado de la orden de compra se calcula automáticamente a partir del estado de sus líneas y no se puede editar directamente. Los estados posibles son:\n\n* pending: Pendiente de recibir. Alguna línea está pendiente de recibir (`pending`)\n* received: Recibida. Ninguna línea está pendiente y al menos una está recibida\n* canceled: Cancelada. Todas las líneas están canceladas\n\nPara cambiar el estado de la orden se cambian los estados de sus líneas (`lines[].state`).",
				"operationId": "getPurchaseOrders",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada en el texto del documento (título, líneas, notas) y en el nombre de su contacto: todas las palabras, sin distinguir acentos ni mayúsculas. Es la búsqueda rápida del listado de la aplicación.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "state",
						"in": "query",
						"description": "Estado de la orden de compra, se pueden indicar varios valores para incluir órdenes en cualquiera de los estados indicados.\n\nEl estado de la orden de compra se calcula automáticamente a partir del estado de sus líneas y no se puede editar directamente. Los estados posibles son:\n\n* pending: Pendiente de recibir. Alguna línea está pendiente de recibir (`pending`)\n* received: Recibida. Ninguna línea está pendiente y al menos una está recibida\n* canceled: Cancelada. Todas las líneas están canceladas\n\nPara cambiar el estado de la orden se cambian los estados de sus líneas (`lines[].state`).",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"pending",
									"received",
									"canceled"
								]
							}
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima de la orden de compra en formato YYYY-MM-DD.\n\nSe incluirán en los resultados órdenes de compra con fecha mayor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima de la orden de compra en formato YYYY-MM-DD.\n\nSe incluirán en los resultados órdenes de compra con fecha menor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "series",
						"in": "query",
						"description": "Serie de la orden de compra sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "formattedSeries",
						"in": "query",
						"description": "Serie de la orden de compra",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minNumber",
						"in": "query",
						"description": "Número secuencial mínimo de la orden de compra\n\nSe incluirán en los resultados órdenes de compra con número secuencial mayor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "maxNumber",
						"in": "query",
						"description": "Número secuencial máximo de la orden de compra.\n\nSe incluirán en los resultados órdenes de compra con número secuencial menor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "contact",
						"in": "query",
						"description": "Proveedor de la orden de compra",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasContact",
						"in": "query",
						"description": "Orden de compra con contacto, utiliza el valor 'false' para obtener órdenes de compra sin contacto asociado",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "minTotal",
						"in": "query",
						"description": "Importe total mínimo de la orden de compra",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "maxTotal",
						"in": "query",
						"description": "Importe total máximo de la orden de compra",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "currency",
						"in": "query",
						"description": "Moneda de la orden de compra (Formato ISO 4217)",
						"schema": {
							"type": "string",
							"minLength": 3,
							"maxLength": 3
						}
					},
					{
						"name": "country",
						"in": "query",
						"description": "País de la dirección fiscal del proveedor (Formato ISO 3166-1 Alpha-2)",
						"schema": {
							"type": "string",
							"minLength": 2,
							"maxLength": 2
						}
					},
					{
						"name": "emails",
						"in": "query",
						"description": "Búsqueda parcial en los emails del documento (campo main.emails).\n\nLa búsqueda no es por coincidencia exacta, sino que realiza una búsqueda parcial insensible a mayúsculas/minúsculas y acentos. Cada palabra del valor proporcionado se busca de forma independiente y deben coincidir todas (operador AND).\n\nPor ejemplo, si el valor de emails del documento es `\"proveedor@empresa.com, admin@empresa.com\"`:\n* `emails=empresa.com` → coincide (búsqueda parcial)\n* `emails=proveedor@empresa` → coincide\n* `emails=proveedor admin` → coincide (ambas palabras están presentes)\n* `emails=otro@dominio.com` → no coincide",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener la orden de compra para ser incluida en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener la orden de compra para ser incluida en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo órdenes de compra que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por fecha y luego por moneda utiliza los parámetros 'sortBy=-date&sortBy=currency'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* date: Fecha de la orden de compra\n* series: Serie de la orden de compra sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)\n* formattedSeries: Serie de la orden de compra\n* number: Número secuencial de la orden de compra\n* total: Importe total de la orden de compra\n* currency: Moneda de la orden de compra\n* country: País de la dirección fiscal de la orden de compra\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date",
									"series",
									"-series",
									"formattedSeries",
									"-formattedSeries",
									"number",
									"-number",
									"total",
									"-total",
									"currency",
									"-currency",
									"country",
									"-country",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la orden de compra, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en la orden de compra",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de órdenes de compra",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPurchaseOrdersResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/PurchaseOrderResponse"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Crear orden de compra",
				"description": "Crea una nueva orden de compra. El contacto de la orden (`main.contact`) es el **proveedor** al que se compra, y los impuestos de las líneas se obtienen del catálogo de impuestos de compras de la empresa (`GET /{companyId}/settings/taxes/purchases`).\n\nEl estado de la orden de compra se calcula automáticamente a partir del estado de sus líneas y no se puede editar directamente. Los estados posibles son:\n\n* pending: Pendiente de recibir. Alguna línea está pendiente de recibir (`pending`)\n* received: Recibida. Ninguna línea está pendiente y al menos una está recibida\n* canceled: Cancelada. Todas las líneas están canceladas\n\nPara cambiar el estado de la orden se cambian los estados de sus líneas (`lines[].state`).\n\nCada línea de la orden de compra tiene su propio estado (`lines[].state`):\n\n* pending: Pendiente de recibir del proveedor\n* received: Recibida\n* canceled: Cancelada\n\nTodo producto referenciado por una línea debe tener activadas sus preferencias de compra. Cuando una línea se vincula a un pedido mediante `clientOrder` y `clientOrderLine`, producto, cantidad y proveedor deben coincidir con la línea de origen.\n\nSi una línea no indica `state` se crea como `pending`, y si no indica `id` FacturaDirecta le asigna uno nuevo.",
				"operationId": "createPurchaseOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la orden de compra a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreatePurchaseOrderRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/PurchaseOrderWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									}
								}
							},
							"examples": {
								"minimal": {
									"summary": "Contenido mínimo para crear una orden de compra",
									"description": "Las líneas se crean en estado `pending`, por lo que la orden queda en estado `pending` (pendiente de recibir)",
									"value": {
										"content": {
											"type": "purchaseOrder",
											"main": {
												"docNumber": {
													"series": "OC"
												},
												"contact": "con_20000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Descripción del artículo a comprar"
													}
												]
											}
										}
									}
								},
								"conEstadosDeLinea": {
									"summary": "Orden de compra indicando el estado de las líneas",
									"description": "Cada línea puede indicar su `state`. El estado de la orden se calcula a partir de los estados de las líneas: en este ejemplo todas están `received`, por lo que la orden queda en estado `received` (recibida).",
									"value": {
										"content": {
											"type": "purchaseOrder",
											"main": {
												"docNumber": {
													"series": "OC"
												},
												"contact": "con_20000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 2,
														"unitPrice": 50,
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Artículo ya recibido del proveedor",
														"state": "received"
													},
													{
														"quantity": 1,
														"unitPrice": 75,
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Otro artículo ya recibido",
														"state": "received"
													}
												]
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación de la orden de compra",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreatePurchaseOrderResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/PurchaseOrder"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/purchaseOrders/{id}": {
			"get": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Obtener una orden de compra",
				"description": "Obtiene el contenido de una orden de compra",
				"operationId": "getPurchaseOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID de la orden de compra. Formado por el prefijo \"pur_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la orden de compra, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en la orden de compra",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido de la orden de compra solicitada",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/PurchaseOrderResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Actualizar orden de compra",
				"description": "Actualiza una orden de compra existente sustituyendo su contenido completo por el recibido.\n\n**Identidad de las líneas (`lines[].id`):** cada línea tiene un identificador estable dentro de la orden que ancla sus vínculos con otros documentos (por ejemplo con las líneas de un pedido de cliente). Al actualizar la orden:\n\n* Las líneas que incluyan un `id` existente conservan su identidad y por tanto sus vínculos.\n* Las líneas sin `id` (o con un `id` nuevo) se tratan como líneas nuevas.\n\nPara modificar una línea conservando su identidad, envíala con el mismo `id` que devolvió la API al crear o consultar la orden.\n\n**Estado de la orden:** `main.state` se recalcula siempre a partir de los estados de las líneas; si se envía se ignora. Para cambiar el estado de la orden cambia los `lines[].state` (por ejemplo, marcando todas las líneas como `received` la orden pasa a `received`).\n\nCada línea de la orden de compra tiene su propio estado (`lines[].state`):\n\n* pending: Pendiente de recibir del proveedor\n* received: Recibida\n* canceled: Cancelada\n\nSustituye el contenido del documento: las líneas se reemplazan por las enviadas y los campos opcionales que no se envían se eliminan. Los campos obligatorios que no se envían conservan su valor, y el número de documento y los metadatos no cambian.",
				"operationId": "updatePurchaseOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID de la orden de compra. Formado por el prefijo \"pur_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la orden de compra a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdatePurchaseOrderRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/PurchaseOrderWrite"
									},
									"syncContactData": {
										"description": "Cuando se indica true, sincroniza automáticamente la dirección (address, country, zipcode) y los datos fiscales de la contraparte (counterpart) a partir del contacto indicado en main.contact. Si main.contact es null, elimina la dirección y la contraparte del documento. No modifica los emails, la posición fiscal, la fecha de recepción prevista ni la cuenta contable",
										"type": "boolean"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de la orden de compra",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdatePurchaseOrderResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/PurchaseOrder"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Borrar orden de compra",
				"description": "Elimina una orden de compra existente",
				"operationId": "deletePurchaseOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID de la orden de compra. Formado por el prefijo \"pur_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/purchaseOrders/{id}/tags": {
			"put": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Actualizar etiquetas de orden de compra",
				"description": "Actualiza las etiquetas de una orden de compra existente",
				"operationId": "updatePurchaseOrderTags",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID de la orden de compra. Formado por el prefijo \"pur_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de las etiquetas a modificar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdatePurchaseOrderTagsRequest",
								"required": [
									"tags",
									"tagsOperation"
								],
								"properties": {
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de las etiquetas de la orden de compra",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdatePurchaseOrderTagsResponse",
									"required": [
										"tags"
									],
									"properties": {
										"tags": {
											"$ref": "#/components/schemas/Tags"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/purchaseOrders/{id}/send": {
			"put": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Enviar orden de compra por correo electrónico",
				"description": "Envía la orden de compra por correo electrónico con destinatarios, título y contenido obtenidos de su plantilla o bien valores personalizados indicados en la llamada",
				"operationId": "sendPurchaseOrder",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID de la orden de compra. Formado por el prefijo \"pur_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/SendDocumentRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/SendDocumentResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/purchaseOrders/{id}/pdf": {
			"put": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Generar la orden de compra en formato PDF",
				"description": "Solicita la generación del documento en formato PDF. Se devuelve una URL temporal desde la que poder descargar el documento en formato PDF\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que solo genera un fichero temporal, así que se puede repetir sin riesgo.",
				"operationId": "createPurchaseOrderPDF",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID de la orden de compra. Formado por el prefijo \"pur_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/CreateDocumentPDFRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/GetDocumentPDFResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/purchaseOrders/{id}/attachments": {
			"post": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Vincular adjuntos a una orden de compra",
				"description": "Vincula uno o varios uploads previamente creados con `POST /api/{companyId}/uploads` a una orden de compra existente. Máximo **10** adjuntos por documento.",
				"operationId": "addPurchaseOrderAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID de la orden de compra. Formado por el prefijo \"pur_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "AddPurchaseOrderAttachmentsRequest",
								"additionalProperties": false,
								"required": [
									"uploadIds"
								],
								"properties": {
									"uploadIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"minItems": 1,
										"description": "Lista de identificadores de upload (`upl_<uuid>`) creados con POST /api/{companyId}/uploads."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Vincular un adjunto",
									"value": {
										"uploadIds": [
											"upl_8a2c1234-1234-1234-1234-123456789012"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Orden de compra con los nuevos adjuntos vinculados",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/PurchaseOrderResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"get": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Listar adjuntos de una orden de compra",
				"operationId": "getPurchaseOrderAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID de la orden de compra. Formado por el prefijo \"pur_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de adjuntos de una orden de compra",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "getPurchaseOrderAttachmentsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Attachment"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/purchaseOrders/{id}/attachments/{attachmentIndex}": {
			"delete": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Eliminar adjunto de una orden de compra",
				"description": "Elimina el adjunto en la posición indicada. Los índices son 0-based. El binario en S3 no se elimina para preservar URLs ya distribuidas.",
				"operationId": "deletePurchaseOrderAttachment",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID de la orden de compra. Formado por el prefijo \"pur_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "attachmentIndex",
						"in": "path",
						"required": true,
						"schema": {
							"type": "integer",
							"minimum": 0
						},
						"description": "Índice (0-based) del adjunto a eliminar."
					}
				],
				"responses": {
					"200": {
						"description": "Adjunto eliminado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "deletePurchaseOrderAttachmentResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/deliveryNotes": {
			"get": {
				"tags": [
					"Albaranes"
				],
				"summary": "Lista de albaranes",
				"description": "Devuelve una lista de albaranes",
				"operationId": "getDeliveryNotes",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada en el texto del documento (título, líneas, notas) y en el nombre de su contacto: todas las palabras, sin distinguir acentos ni mayúsculas. Es la búsqueda rápida del listado de la aplicación.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima del albarán en formato YYYY-MM-DD.\n\nSe incluirán en los resultados albaranes con fecha mayor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima del albarán en formato YYYY-MM-DD.\n\nSe incluirán en los resultados albaranes con fecha menor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "series",
						"in": "query",
						"description": "Serie del albarán sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "formattedSeries",
						"in": "query",
						"description": "Serie del albarán",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minNumber",
						"in": "query",
						"description": "Número secuencial mínimo del albarán\n            \nSe incluirán en los resultados albaranes con número secuencial mayor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "maxNumber",
						"in": "query",
						"description": "Número secuencial máximo del albarán.\n            \nSe incluirán en los resultados albaranes con número secuencial menor o igual al valor indicado",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "contact",
						"in": "query",
						"description": "Cliente del albarán",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasContact",
						"in": "query",
						"description": "Albarán con contacto, utiliza el valor 'false' para obtener albaranes sin contacto asociado",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "minTotal",
						"in": "query",
						"description": "Importe total mínimo del albarán",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "maxTotal",
						"in": "query",
						"description": "Importe total máximo del albarán",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "currency",
						"in": "query",
						"description": "Moneda del albarán (Formato ISO 4217)",
						"schema": {
							"type": "string",
							"minLength": 3,
							"maxLength": 3
						}
					},
					{
						"name": "country",
						"in": "query",
						"description": "País de la dirección de facturación (Formato ISO 3166-1 Alpha-2)",
						"schema": {
							"type": "string",
							"minLength": 2,
							"maxLength": 2
						}
					},
					{
						"name": "emails",
						"in": "query",
						"description": "Búsqueda parcial en los emails del documento (campo main.emails).\n\nLa búsqueda no es por coincidencia exacta, sino que realiza una búsqueda parcial insensible a mayúsculas/minúsculas y acentos. Cada palabra del valor proporcionado se busca de forma independiente y deben coincidir todas (operador AND).\n\nPor ejemplo, si el valor de emails del documento es `\"cliente@empresa.com, admin@empresa.com\"`:\n* `emails=empresa.com` → coincide (búsqueda parcial)\n* `emails=cliente@empresa` → coincide\n* `emails=cliente admin` → coincide (ambas palabras están presentes)\n* `emails=otro@dominio.com` → no coincide",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener el albarán para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener el albarán para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo albaranes que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por fecha y luego por moneda utiliza los parámetros 'sortBy=-date&sortBy=currency'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* date: Fecha de albarán\n* series: Serie del albarán sin aplicar posibles formatos de año (\\#\\# ó \\#\\#\\#\\#)\n* formattedSeries: Serie del albarán\n* number: Número secuencial mínimo del albarán \n* total: Importe total del albarán\n* currency: Moneda del albarán\n* country: País de la dirección fiscal del albarán\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date",
									"series",
									"-series",
									"formattedSeries",
									"-formattedSeries",
									"number",
									"-number",
									"total",
									"-total",
									"currency",
									"-currency",
									"country",
									"-country",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con el albarán, se pueden indicar tantos valores como sea necesario entre los siguientes:\n  \n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en el albarán",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de albaranes",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetDeliveryNotesResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/DeliveryNoteResponse"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Albaranes"
				],
				"summary": "Crear albarán",
				"description": "Crea un nuevo albarán",
				"operationId": "createDeliveryNote",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del albarán a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateDeliveryNoteRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/DeliveryNoteWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									}
								}
							},
							"examples": {
								"minimal": {
									"summary": "Contenido mínimo para crear un albarán",
									"value": {
										"content": {
											"type": "deliveryNote",
											"main": {
												"docNumber": {
													"series": "AL"
												},
												"baseState": "pending",
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 50,
														"tax": [
															"S_IVA_21"
														],
														"text": "Descripción del producto 1"
													}
												]
											}
										}
									}
								},
								"autoTaxes": {
									"summary": "Albarán sin especificar `tax` (resolución automática)",
									"description": "Cuando `tax` se omite, FacturaDirecta usa los impuestos del producto (si la línea referencia uno en `document`) o los impuestos por defecto de la empresa (`settings.taxes.sales`) y aplica la posición fiscal del contacto. Para indicar explícitamente que la línea no lleva impuestos, enviar `tax: []`.",
									"value": {
										"content": {
											"type": "deliveryNote",
											"main": {
												"docNumber": {
													"series": "AL"
												},
												"baseState": "pending",
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"currency": "EUR",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 50,
														"text": "Línea sin tax: se aplican los impuestos por defecto de la empresa"
													}
												]
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación del albarán",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateDeliveryNoteResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/DeliveryNote"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/deliveryNotes/{id}": {
			"get": {
				"tags": [
					"Albaranes"
				],
				"summary": "Obtener un albarán",
				"description": "Obtiene el contenido de un albarán",
				"operationId": "getDeliveryNote",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del albarán. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con el albarán, se pueden indicar tantos valores como sea necesario entre los siguientes:\n  \n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en el albarán",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido del albarán solicitado",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/DeliveryNoteResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Albaranes"
				],
				"summary": "Actualizar albarán",
				"description": "Actualiza un albarán existente. Sustituye el contenido del documento: las líneas se reemplazan por las enviadas y los campos opcionales que no se envían se eliminan. Los campos obligatorios que no se envían conservan su valor, y el número de documento y los metadatos no cambian.",
				"operationId": "updateDeliveryNote",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del albarán. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del albarán a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateDeliveryNoteRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/DeliveryNoteWrite"
									},
									"syncContactData": {
										"description": "Cuando se indica true, sincroniza automáticamente la dirección (address, country, zipcode) y los datos fiscales de la contraparte (counterpart) a partir del contacto indicado en main.contact. Si main.contact es null, elimina la dirección y la contraparte del documento. No modifica los emails, la posición fiscal, la fecha de vencimiento ni la cuenta contable",
										"type": "boolean"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización del albarán",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateDeliveryNoteResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/DeliveryNote"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Albaranes"
				],
				"summary": "Borrar albarán",
				"description": "Elimina un albarán existente",
				"operationId": "deleteDeliveryNote",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del albarán. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/deliveryNotes/{id}/tags": {
			"put": {
				"tags": [
					"Albaranes"
				],
				"summary": "Actualizar etiquetas de albarán",
				"description": "Actualiza las etiquetas de un albarán existente",
				"operationId": "updateDeliveryNoteTags",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del albarán. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de las etiquetas a modificar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateDeliveryNoteTagsRequest",
								"required": [
									"tags",
									"tagsOperation"
								],
								"properties": {
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de las etiquetas del albarán",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateDeliveryNoteTagsResponse",
									"required": [
										"tags"
									],
									"properties": {
										"tags": {
											"$ref": "#/components/schemas/Tags"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/deliveryNotes/{id}/send": {
			"put": {
				"tags": [
					"Albaranes"
				],
				"summary": "Enviar albarán por correo electrónico",
				"description": "Envía el albarán por correo electrónico con destinatarios, título y contenido obtenidos de su plantilla o bien valores personalizados indicados en la llamada",
				"operationId": "sendDeliveryNote",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del albarán. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/SendDocumentRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/SendDocumentResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/deliveryNotes/{id}/pdf": {
			"put": {
				"tags": [
					"Albaranes"
				],
				"summary": "Generar el albarán en formato PDF",
				"description": "Solicita la generación del documento en formato PDF. Se devuelve una URL temporal desde la que poder descargar el documento en formato PDF\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que solo genera un fichero temporal, así que se puede repetir sin riesgo.",
				"operationId": "createDeliveryNotePDF",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura. Formado por el prefjo \"inv_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/CreateDocumentPDFRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/GetDocumentPDFResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/deliveryNotes/{id}/attachments": {
			"post": {
				"tags": [
					"Albaranes"
				],
				"summary": "Vincular adjuntos a un albarán",
				"description": "Vincula uno o varios uploads previamente creados con `POST /api/{companyId}/uploads` a un albarán existente. Máximo **10** adjuntos por documento.",
				"operationId": "addDeliveryNoteAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del albarán. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "AddDeliveryNoteAttachmentsRequest",
								"additionalProperties": false,
								"required": [
									"uploadIds"
								],
								"properties": {
									"uploadIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"minItems": 1,
										"description": "Lista de identificadores de upload (`upl_<uuid>`) creados con POST /api/{companyId}/uploads."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Vincular un adjunto",
									"value": {
										"uploadIds": [
											"upl_8a2c1234-1234-1234-1234-123456789012"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Albarán con los nuevos adjuntos vinculados",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/DeliveryNoteResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"get": {
				"tags": [
					"Albaranes"
				],
				"summary": "Listar adjuntos de un albarán",
				"operationId": "getDeliveryNoteAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del albarán. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de adjuntos de un albarán",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "getDeliveryNoteAttachmentsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Attachment"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/deliveryNotes/{id}/attachments/{attachmentIndex}": {
			"delete": {
				"tags": [
					"Albaranes"
				],
				"summary": "Eliminar adjunto de un albarán",
				"description": "Elimina el adjunto en la posición indicada. Los índices son 0-based. El binario en S3 no se elimina para preservar URLs ya distribuidas.",
				"operationId": "deleteDeliveryNoteAttachment",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del albarán. Formado por el prefjo \"est_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "attachmentIndex",
						"in": "path",
						"required": true,
						"schema": {
							"type": "integer",
							"minimum": 0
						},
						"description": "Índice (0-based) del adjunto a eliminar."
					}
				],
				"responses": {
					"200": {
						"description": "Adjunto eliminado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "deleteDeliveryNoteAttachmentResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/bills": {
			"get": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Lista de facturas de compra o tickets",
				"description": "Devuelve una lista de facturas de compra o tickets",
				"operationId": "getBills",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada en el texto del documento (título, líneas, notas) y en el nombre de su contacto: todas las palabras, sin distinguir acentos ni mayúsculas. Es la búsqueda rápida del listado de la aplicación.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima de registro de la factura de compra o ticket en formato YYYY-MM-DD.\n\nSe incluirán en los resultados facturas de compra o tickets con fecha de registro mayor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima de registro de la factura de compra o ticket en formato YYYY-MM-DD.\n\nSe incluirán en los resultados facturas de compra o tickets con fecha de registro menor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "contact",
						"in": "query",
						"description": "Proveedor de la factura",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasContact",
						"in": "query",
						"description": "Factura de compra con contacto, utiliza el valor 'false' para obtener las facturas de compra o tickets sin proveedor asociado",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "minTotal",
						"in": "query",
						"description": "Importe total mínimo de la factura de compra o ticket",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "maxTotal",
						"in": "query",
						"description": "Importe total máximo de la factura de compra o ticket",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "currency",
						"in": "query",
						"description": "Moneda de la factura de compra o ticket (Formato ISO 4217)",
						"schema": {
							"type": "string",
							"minLength": 3,
							"maxLength": 3
						}
					},
					{
						"name": "state",
						"in": "query",
						"description": "Estados de factura de compra o ticket a incluir. Cada documento tiene un único estado en cada momento; estos valores son excluyentes entre sí. Si se indican varios, se incluyen los documentos cuyo estado sea cualquiera de ellos.\n\n* draft: Borrador o documento provisional; no genera asientos contables\n* pending: Documento definitivo con saldo pendiente que aún no ha vencido\n* overdue: Documento definitivo con saldo pendiente vencido según sus vencimientos\n* paid: Documento definitivo con saldo pendiente cero\n* overpaid: Documento definitivo cuyos pagos superan el importe esperado\n* voided: Documento anulado",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"draft",
									"pending",
									"overdue",
									"paid",
									"overpaid",
									"voided"
								]
							}
						}
					},
					{
						"name": "totals",
						"in": "query",
						"description": "Con `true`, añade `totals` a la respuesta: el recuento y la suma de la base imponible, los impuestos, el total y el importe pendiente de todas las facturas de compra y tickets que cumplen los filtros (no solo de la página), con una fila por moneda. Es la forma de responder «¿cuánto suman?» sin paginar.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "draft",
						"in": "query",
						"description": "Comportamiento de las facturas provisionales. Si no se indica nada se incluirán solo las facturas definitivas. Los borradores no generan asientos contables; cuando se incluyen, el recuento del listado puede no coincidir con el diario.\n\n* only: Se incluirán solo las facturas provisionales\n* all: Se incluirán todas las facturas (definitivas y provisionales)",
						"schema": {
							"type": "string",
							"enum": [
								"only",
								"all"
							]
						}
					},
					{
						"name": "country",
						"in": "query",
						"description": "País de la dirección fiscal del proveedor (Formato ISO 3166-1 Alpha-2)",
						"schema": {
							"type": "string",
							"minLength": 2,
							"maxLength": 2
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener la factura de compra o ticket para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener la factura de compra o ticket para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo facturas de compra o tickets que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por fecha y luego por moneda utiliza los parámetros 'sortBy=-date&sortBy=currency'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* date: Fecha de registro de la factura de compra o ticket\n* total: Importe total de la factura de compra o ticket\n* currency: Moneda de la factura de compra o ticket\n* country: País de la dirección fiscal de la factura de compra o ticket\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date",
									"total",
									"-total",
									"currency",
									"-currency",
									"country",
									"-country",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la factura de compra o ticket, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en la factura de compra o ticket\n* balance: Devuelve en related.balance detalle del saldo pendiente de la factura de compra o ticket\n* state: Devuelve en related.state el estado de la factura de compra o ticket (draft, pending, overdue, paid, overpaid, voided)\n* journal: Devuelve en related.journal los apuntes contables que afectan al saldo de la factura de compra o ticket (mismo shape que `GET /journal?document={id}`, incluyendo `tra_` asientos contables y `pay_` remesas SEPA)",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds",
									"balance",
									"state",
									"journal"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de facturas de compra o tickets",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetBillsResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/BillResponse"
											}
										},
										"totals": {
											"type": "array",
											"description": "Solo con `totals=true`: totales del conjunto filtrado completo, una fila por moneda",
											"items": {
												"type": "object",
												"title": "ListTotals",
												"additionalProperties": false,
												"required": [
													"currency",
													"count",
													"total",
													"totalBeforeTaxes",
													"taxes",
													"pending",
													"companyCurrencyPending"
												],
												"properties": {
													"currency": {
														"type": "string",
														"nullable": true,
														"description": "Moneda de los documentos de la fila"
													},
													"count": {
														"type": "integer",
														"description": "Documentos que cumplen los filtros"
													},
													"total": {
														"type": "number",
														"description": "Suma del total, impuestos incluidos, en la moneda de la fila"
													},
													"totalBeforeTaxes": {
														"type": "number",
														"description": "Suma de la base imponible, en la moneda de la fila"
													},
													"taxes": {
														"type": "number",
														"description": "Suma de los impuestos: `total` menos `totalBeforeTaxes`"
													},
													"pending": {
														"type": "number",
														"description": "Importe pendiente de pago, en positivo, en la moneda de la fila; negativo si se ha pagado de más"
													},
													"companyCurrencyPending": {
														"type": "number",
														"description": "Importe pendiente de pago en la moneda de la empresa"
													}
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Crear factura de compra o ticket",
				"description": "Crea una nueva factura de compra o ticket",
				"operationId": "createBill",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la factura de compra o ticket a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateBillRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/BillWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"fromInbox": {
										"type": "object",
										"description": "Si se indica, la factura se crea vinculando un item de la bandeja de entrada (`tas_*`). El adjunto del inbox se reutiliza como adjunto de esta factura sin re-upload, y por defecto el item se archiva. Equivale al flujo agente: subir PDF a `/inbox` → escanear → crear bill desde la extracción.",
										"required": [
											"taskId"
										],
										"properties": {
											"taskId": {
												"type": "string",
												"description": "Identificador del item de la bandeja (`tas_*`)."
											},
											"archive": {
												"type": "boolean",
												"default": true,
												"description": "Si `true` (defecto) se archiva el inbox tras vincularlo."
											}
										}
									}
								}
							},
							"examples": {
								"services": {
									"summary": "Factura de compra de servicios",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "SV-YYYY-001",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"account": "600000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Servicio profesional"
													}
												]
											}
										}
									}
								},
								"installments": {
									"summary": "Factura de compra con varios vencimientos",
									"description": "Cada elemento de `installments` define un pago previsto con fecha, importe y moneda. Los vencimientos pendientes se pueden seleccionar por separado al preparar una remesa SEPA de transferencias. `dueDate` se ajusta automáticamente a la fecha del último vencimiento.",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "PL-YYYY-001",
												"currency": "EUR",
												"account": "400000",
												"installments": [
													{
														"date": "2026-07-15",
														"amount": 60.5,
														"currency": "EUR"
													},
													{
														"date": "2026-08-15",
														"amount": 60.5,
														"currency": "EUR"
													}
												],
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"account": "600000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Servicio profesional"
													}
												]
											}
										}
									}
								},
								"autoTaxes": {
									"summary": "Factura de compra sin especificar `tax` (resolución automática)",
									"description": "Cuando `tax` se omite, FacturaDirecta usa los impuestos del producto (si la línea referencia uno en `document`) o los impuestos por defecto de la empresa (`settings.taxes.purchases`) y aplica la posición fiscal del contacto. Para indicar explícitamente que la línea no lleva impuestos, enviar `tax: []`.",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "AUTO-YYYY-001",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"account": "600000",
														"text": "Línea sin tax: se aplican los impuestos por defecto de la empresa"
													}
												]
											}
										}
									}
								},
								"goods": {
									"summary": "Factura de compra de bienes corrientes",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "BC-YYYY-042",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 75,
														"account": "600000",
														"tax": [
															"P_IVA_21_BC"
														],
														"text": "Material de oficina"
													}
												]
											}
										}
									}
								},
								"lineTotal": {
									"summary": "Factura de compra sin desglose de cantidad (usando lineTotal)",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "LT-YYYY-018",
												"showQuantityColumn": false,
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"lineTotal": 250,
														"account": "629000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Cuota mensual servicio informático"
													},
													{
														"lineTotal": 35,
														"account": "628000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Suministros"
													}
												]
											}
										}
									}
								},
								"multipleTaxes": {
									"summary": "Factura de compra con dos tipos de IVA",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "MT-YYYY-103",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"account": "600000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Servicio de consultoría"
													},
													{
														"quantity": 1,
														"unitPrice": 50,
														"account": "600000",
														"tax": [
															"P_IVA_10_SV"
														],
														"text": "Servicio de mantenimiento"
													}
												]
											}
										}
									}
								},
								"nonDeductible": {
									"summary": "Factura de compra con IVA soportado no deducible",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "ND-YYYY-007",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 500,
														"account": "600000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Gasto con IVA no deducible",
														"nonDeductibleTax": true
													}
												]
											}
										}
									}
								},
								"partiallyDeductible": {
									"summary": "Factura de compra con IVA parcialmente deducible",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "PD-YYYY-015",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 50,
														"account": "600000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Parte con IVA deducible"
													},
													{
														"quantity": 1,
														"unitPrice": 50,
														"account": "600000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Parte con IVA no deducible",
														"nonDeductibleTax": true
													}
												]
											}
										}
									}
								},
								"irpf": {
									"summary": "Factura de compra con retención de IRPF",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "IRPF-YYYY-022",
												"currency": "EUR",
												"account": "400000",
												"fiscalPosition": "aut",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 500,
														"account": "623000",
														"tax": [
															"P_IVA_21_SV",
															"P_IRPF_15"
														],
														"text": "Servicios profesionales"
													}
												]
											}
										}
									}
								},
								"rent": {
									"summary": "Factura de compra con retención de alquileres",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "ALQ-YYYY-004",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 1200,
														"account": "600000",
														"tax": [
															"P_IVA_21_SV",
															"P_IRPF_19_URB"
														],
														"text": "Alquiler oficina"
													}
												]
											}
										}
									}
								},
								"reimbursements": {
									"summary": "Factura de compra con suplidos",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "SUP-YYYY-009",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 100,
														"account": "600000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Servicios"
													},
													{
														"quantity": 1,
														"unitPrice": 4.5,
														"account": "566000",
														"tax": [
															"P_SUPLIDOS"
														],
														"text": "Tasa (suplidos)"
													}
												]
											}
										}
									}
								},
								"importGoods": {
									"summary": "Importación de bienes con IVA pendiente de repercutir en aduana",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "IMP-YYYY-031",
												"currency": "USD",
												"account": "400000",
												"fiscalPosition": "emp_ex",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 1000,
														"account": "600000",
														"tax": [
															"P_IVA_0_BC_PDUA"
														],
														"text": "Importación de productos"
													}
												]
											}
										}
									}
								},
								"customsAgent": {
									"summary": "Factura de agente de aduanas con IVA de importación",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"referenceNumber": "ADU-YYYY-031",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"quantity": 1,
														"unitPrice": 50,
														"account": "600000",
														"tax": [
															"P_IVA_21_SV"
														],
														"text": "Trámites de aduana"
													},
													{
														"quantity": 1,
														"unitPrice": 210,
														"account": "600000",
														"tax": [
															"P_IVA_21_BC_EX_AT"
														],
														"text": "IVA de productos importados por valor de 1.000€"
													}
												]
											}
										}
									}
								},
								"ticket": {
									"summary": "Ticket (factura simplificada) sin contacto",
									"value": {
										"content": {
											"type": "bill",
											"main": {
												"subtype": "ticket",
												"contact": null,
												"referenceNumber": "PKG-YYYY-001",
												"currency": "EUR",
												"account": "400000",
												"lines": [
													{
														"lineTotal": 4.95,
														"account": "600000",
														"tax": [],
														"text": "Parking"
													}
												]
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación de la factura de compra o ticket",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateBillResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Bill"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/bills/{id}": {
			"get": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Obtener una factura de compra o ticket",
				"description": "Obtiene el contenido de una factura de compra o ticket",
				"operationId": "getBill",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura de compra o ticket. Formado por el prefjo \"bil_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la factura de compra o ticket, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* taxIds: Devuelve en related.objects detalles de las definiciones de los impuestos incluidos en la factura de compra o ticket\n* balance: Devuelve en related.balance detalle del saldo pendiente de la factura de compra o ticket\n* state: Devuelve en related.state el estado de la factura de compra o ticket (draft, pending, overdue, paid, overpaid, voided)\n* journal: Devuelve en related.journal los apuntes contables que afectan al saldo de la factura de compra o ticket (mismo shape que `GET /journal?document={id}`, incluyendo `tra_` asientos contables y `pay_` remesas SEPA)",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"taxIds",
									"balance",
									"state",
									"journal"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido de la factura de compra o ticket solicitada",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/BillResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Actualizar factura de compra o ticket",
				"description": "Actualiza una factura de compra o ticket existente. Sustituye el contenido del documento: las líneas se reemplazan por las enviadas y los campos opcionales que no se envían se eliminan. Los campos obligatorios que no se envían conservan su valor y los metadatos no cambian.",
				"operationId": "updateBill",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura de compra o ticket. Formado por el prefjo \"bil_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la factura de compra o ticket a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateBillRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/BillWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de la factura de compra o ticket",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateBillResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Bill"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Borrar factura de compra o ticket",
				"description": "Elimina una factura de compra o ticket existente",
				"operationId": "deleteBill",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura de compra o ticket. Formado por el prefjo \"bil_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/bills/{id}/tags": {
			"put": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Actualizar etiquetas de factura de compra o ticket",
				"description": "Actualiza las etiquetas de una factura de compra o ticket existente",
				"operationId": "updateBillTags",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura de compra o ticket. Formado por el prefjo \"bil_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de las etiquetas a modificar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateBillTagsRequest",
								"required": [
									"tags",
									"tagsOperation"
								],
								"properties": {
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de las etiquetas de la factura de compra o ticket",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateBillTagsResponse",
									"required": [
										"tags"
									],
									"properties": {
										"tags": {
											"$ref": "#/components/schemas/Tags"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/bills/{id}/payments": {
			"post": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Crear pagos para una factura de compra o ticket",
				"description": "Crear pagos para una factura de compra o ticket\n\nLa respuesta es la factura de compra completa actualizada (`BillPaymentsWriteResponse`, mismo shape que crear o consultar la factura).\n\nPara obtener directamente en la respuesta los apuntes contables que componen el saldo (incluyendo el recién creado), pasa `related=journal` en el body. Cada apunte trae `id` polimórfico (`tra_<uuid-v4>` para asientos contables directos, `pay_<uuid-v4>` para remesas SEPA), `account`, `debit`, `credit`, `date` y campos de multicurrency cuando aplica. Útil para encadenar el pago recién registrado con `PUT /{companyId}/statements/{id}/reconciliation` sin un round-trip extra.\n\nAlternativa: `GET /{companyId}/journal?document={id}&related=idAccounting` devuelve los mismos apuntes con más detalle (incluyendo el asiento del propio documento, su `idAccounting` completo y opcionalmente `tags`).",
				"operationId": "createBillPayments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura de compra o ticket. Formado por el prefjo \"bil_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de los pagos a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateBillPaymentsRequest",
								"required": [
									"payments"
								],
								"properties": {
									"payments": {
										"$ref": "#/components/schemas/BillPaymentsWrite"
									},
									"related": {
										"type": "array",
										"items": {
											"type": "string",
											"enum": [
												"taxIds",
												"balance",
												"state",
												"journal"
											]
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación de pagos en la factura de compra o ticket. Se devuelve la factura de compra o ticket completa igual que en la operación de consulta de la misma",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/BillPaymentsWriteResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/bills/{id}/attachments": {
			"post": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Vincular adjuntos a una factura de compra o ticket",
				"description": "Vincula uno o varios adjuntos a una factura de compra o ticket existente. Los adjuntos pueden venir de dos fuentes:\n\n* **`uploadIds`**: identificadores de upload creados con `POST /api/{companyId}/uploads`. Los uploads pasan a estado `consumed` y el archivo se promueve a la ruta canónica de la empresa.\n* **`inboxIds`**: identificadores de items de la bandeja de entrada (`tas_*`). Se reutiliza el adjunto que ya tiene el inbox (sin re-upload) y por defecto el item se archiva.\n\nSe puede combinar ambos en la misma llamada. Los nuevos adjuntos se añaden a los existentes (no los sustituyen).\n\nUn documento puede tener un máximo de **10** adjuntos.",
				"operationId": "addBillAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura de compra o ticket. Formado por el prefjo \"bil_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "AddBillAttachmentsRequest",
								"additionalProperties": false,
								"description": "Debes indicar al menos uno entre `uploadIds` o `inboxIds`.",
								"properties": {
									"uploadIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"description": "Lista de identificadores de upload (`upl_<uuid>`) creados con POST /api/{companyId}/uploads."
									},
									"inboxIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"description": "Lista de identificadores de items de la bandeja (`tas_<uuid>`). Se reutiliza el adjunto de cada item sin re-upload."
									},
									"archiveInbox": {
										"type": "boolean",
										"default": true,
										"description": "Si `true` (defecto), los items vinculados vía `inboxIds` se archivan tras vincularlos. Solo aplica a `inboxIds`."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Vincular un upload",
									"value": {
										"uploadIds": [
											"upl_8a2c1234-1234-1234-1234-123456789012"
										]
									}
								},
								"fromInbox": {
									"summary": "Vincular un item de la bandeja",
									"value": {
										"inboxIds": [
											"tas_4b5dbc2d-3060-4fd1-92d4-69a054c7d4a2"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Factura de compra o ticket con los nuevos adjuntos vinculados",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/BillResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"get": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Listar adjuntos de una factura de compra o ticket",
				"operationId": "getBillAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura de compra o ticket. Formado por el prefjo \"bil_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de adjuntos de una factura de compra o ticket",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "getBillAttachmentsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Attachment"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/bills/{id}/attachments/{attachmentIndex}": {
			"delete": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Eliminar adjunto de una factura de compra o ticket",
				"description": "Elimina el adjunto en la posición indicada. Los índices son 0-based. El binario en S3 no se elimina para preservar URLs ya distribuidas.",
				"operationId": "deleteBillAttachment",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la factura de compra o ticket. Formado por el prefjo \"bil_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "attachmentIndex",
						"in": "path",
						"required": true,
						"schema": {
							"type": "integer",
							"minimum": 0
						},
						"description": "Índice (0-based) del adjunto a eliminar."
					}
				],
				"responses": {
					"200": {
						"description": "Adjunto eliminado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "deleteBillAttachmentResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/payrolls": {
			"get": {
				"tags": [
					"Nóminas"
				],
				"summary": "Lista de nóminas",
				"description": "Devuelve una lista de nóminas",
				"operationId": "getPayrolls",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "search",
						"in": "query",
						"description": "Búsqueda aproximada en el texto del documento (título, líneas, notas) y en el nombre de su contacto: todas las palabras, sin distinguir acentos ni mayúsculas. Es la búsqueda rápida del listado de la aplicación.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima de la nómina en formato YYYY-MM-DD.\n\nSe incluirán en los resultados nóminas con fecha mayor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima de la nómina en formato YYYY-MM-DD.\n\nSe incluirán en los resultados nóminas con fecha menor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "contact",
						"in": "query",
						"description": "Empleado",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "minTotal",
						"in": "query",
						"description": "Importe total mínimo de la nómina",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "maxTotal",
						"in": "query",
						"description": "Importe total máximo de la nómina",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "state",
						"in": "query",
						"description": "Estado de la nómina",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"pending",
									"overdue",
									"paid",
									"overpaid"
								]
							}
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener la nómina para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener la nómina para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo nóminas que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por fecha y luego por importe total ascendente utiliza los parámetros 'sortBy=-date&sortBy=total'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* date: Fecha de factura\n* total: Importe total de la factura\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date",
									"total",
									"-total",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la nómina, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* balance: Devuelve en related.balance detalle del saldo pendiente de la nómina\n* state: Devuelve en related.state el estado de la nómina (pending, overdue, paid, overpaid)\n* journal: Devuelve en related.journal los apuntes contables que afectan al saldo de la nómina (mismo shape que `GET /journal?document={id}`, incluyendo `tra_` asientos contables y `pay_` remesas SEPA)",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"balance",
									"state",
									"journal"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de nóminas",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPayrollsResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/PayrollResponse"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Nóminas"
				],
				"summary": "Crear nómina",
				"description": "Crear una nueva nómina",
				"operationId": "createPayroll",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la nómina a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreatePayrollRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/PayrollWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"payments": {
										"$ref": "#/components/schemas/PayrollPaymentsWrite"
									},
									"fromInbox": {
										"type": "object",
										"description": "Si se indica, la nómina se crea vinculando un item de la bandeja de entrada (`tas_*`). El adjunto del inbox se reutiliza como adjunto de esta nómina sin re-upload, y por defecto el item se archiva. Para construir el `content` automáticamente desde la extracción del escáner, llama primero a `POST /inbox/{taskId}/proposePayroll` y reenvía el resultado en `content`.",
										"required": [
											"taskId"
										],
										"properties": {
											"taskId": {
												"type": "string",
												"description": "Identificador del item de la bandeja (`tas_*`)."
											},
											"archive": {
												"type": "boolean",
												"default": true,
												"description": "Si `true` (defecto) se archiva el inbox tras vincularlo."
											}
										}
									}
								}
							},
							"examples": {
								"minimal": {
									"summary": "Contenido mínimo para crear una nómina",
									"value": {
										"content": {
											"type": "payroll",
											"main": {
												"date": "2023-05-31",
												"contact": "con_40000000-0000-4000-8000-000000000000",
												"modelo190": {
													"clavePercepcion": "A"
												},
												"lines": [
													{
														"type": "debit",
														"label": "Percepción salarial",
														"account": "640000",
														"lineTotal": 2000
													},
													{
														"type": "ss_employee",
														"label": "Aportación Seg.Soc. trabajador",
														"account": "476000",
														"base": 2000,
														"lineTotal": 120
													},
													{
														"type": "irpf_employee",
														"label": "Retenciones IRPF (Percepciones dinerarias)",
														"account": "475100",
														"base": 2000,
														"lineTotal": 240
													},
													{
														"type": "ss_company",
														"label": "Aportaciones Cotización Seg.Soc. Empresa",
														"account": "642000",
														"base": 2000,
														"lineTotal": 600
													}
												]
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación de la nómina",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreatePayrollResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Payroll"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/payrolls/{id}": {
			"get": {
				"tags": [
					"Nóminas"
				],
				"summary": "Obtener una nómina",
				"description": "Obtiene el contenido de una nómina",
				"operationId": "getPayroll",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la nómina. Formado por el prefjo \"par_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con la nómina, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* balance: Devuelve en related.balance detalle del saldo pendiente de la nómina\n* state: Devuelve en related.state el estado de la nómina (pending, overdue, paid, overpaid)\n* journal: Devuelve en related.journal los apuntes contables que afectan al saldo de la nómina (mismo shape que `GET /journal?document={id}`, incluyendo `tra_` asientos contables y `pay_` remesas SEPA)",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"balance",
									"state",
									"journal"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido de la nómina solicitada",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/PayrollResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Nóminas"
				],
				"summary": "Actualizar nómina",
				"description": "Actualiza una nómina existente. Sustituye el contenido del documento: las líneas se reemplazan por las enviadas y los campos opcionales que no se envían se eliminan. Los campos obligatorios que no se envían conservan su valor y los metadatos no cambian.",
				"operationId": "updatePayroll",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la nómina. Formado por el prefjo \"par_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido de la nómina a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdatePayrollRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/PayrollWrite"
									},
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de la nómina",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdatePayrollResponse",
									"required": [
										"content",
										"tags",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Payroll"
										},
										"tags": {
											"$ref": "#/components/schemas/Tags"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Nóminas"
				],
				"summary": "Borrar nómina",
				"description": "Elimina una nómina existente",
				"operationId": "deletePayroll",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la nómina. Formado por el prefjo \"par_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/payrolls/{id}/payments": {
			"post": {
				"tags": [
					"Nóminas"
				],
				"summary": "Crear pagos para una nómina",
				"description": "Crear pagos para una nómina\n\nLa respuesta es la nómina completa actualizada (`PayrollPaymentsWriteResponse`, mismo shape que crear o consultar la nómina).\n\nPara obtener directamente en la respuesta los apuntes contables que componen el saldo (incluyendo el recién creado), pasa `related=journal` en el body. Cada apunte trae `id` polimórfico (`tra_<uuid-v4>` para asientos contables directos, `pay_<uuid-v4>` para remesas SEPA), `account`, `debit`, `credit`, `date` y campos de multicurrency cuando aplica. Útil para encadenar el pago recién registrado con `PUT /{companyId}/statements/{id}/reconciliation` sin un round-trip extra.\n\nAlternativa: `GET /{companyId}/journal?document={id}&related=idAccounting` devuelve los mismos apuntes con más detalle (incluyendo el asiento de la propia nómina, su `idAccounting` completo y opcionalmente `tags`).",
				"operationId": "createPayrollPayments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la nómina. Formado por el prefjo \"par_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de los pagos a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreatePayrollPaymentsRequest",
								"required": [
									"payments"
								],
								"properties": {
									"payments": {
										"$ref": "#/components/schemas/PayrollPaymentsWrite"
									},
									"related": {
										"type": "array",
										"items": {
											"type": "string",
											"enum": [
												"balance",
												"state",
												"journal"
											]
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación de pagos en la nómina. Se devuelve la nómina completa igual que en la operación de consulta de la misma",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/PayrollPaymentsWriteResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/payrolls/{id}/tags": {
			"put": {
				"tags": [
					"Nóminas"
				],
				"summary": "Actualizar etiquetas de nómina",
				"description": "Actualiza las etiquetas de una nómina existente",
				"operationId": "updatePayrollTags",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la nómina. Formado por el prefjo \"par_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Especificación de las etiquetas a modificar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdatePayrollTagsRequest",
								"required": [
									"tags",
									"tagsOperation"
								],
								"properties": {
									"tags": {
										"$ref": "#/components/schemas/Tags"
									},
									"tagsOperation": {
										"$ref": "#/components/schemas/TagsOperation"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización de las etiquetas de la nómina",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdatePayrollTagsResponse",
									"required": [
										"tags"
									],
									"properties": {
										"tags": {
											"$ref": "#/components/schemas/Tags"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/payrolls/{id}/attachments": {
			"post": {
				"tags": [
					"Nóminas"
				],
				"summary": "Vincular adjuntos a una nómina",
				"description": "Vincula uno o varios adjuntos a una nómina existente. Los adjuntos pueden venir de dos fuentes:\n\n* **`uploadIds`**: identificadores de upload creados con `POST /api/{companyId}/uploads`. Los uploads pasan a estado `consumed` y el archivo se promueve a la ruta canónica de la empresa.\n* **`inboxIds`**: identificadores de items de la bandeja de entrada (`tas_*`). Se reutiliza el adjunto que ya tiene el inbox (sin re-upload) y por defecto el item se archiva.\n\nSe puede combinar ambos en la misma llamada. Los nuevos adjuntos se añaden a los existentes (no los sustituyen).\n\nMáximo **10** adjuntos por documento.",
				"operationId": "addPayrollAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la nómina. Formado por el prefjo \"par_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "AddPayrollAttachmentsRequest",
								"additionalProperties": false,
								"description": "Debes indicar al menos uno entre `uploadIds` o `inboxIds`.",
								"properties": {
									"uploadIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"description": "Lista de identificadores de upload (`upl_<uuid>`) creados con POST /api/{companyId}/uploads."
									},
									"inboxIds": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"description": "Lista de identificadores de items de la bandeja (`tas_<uuid>`). Se reutiliza el adjunto de cada item sin re-upload."
									},
									"archiveInbox": {
										"type": "boolean",
										"default": true,
										"description": "Si `true` (defecto), los items vinculados vía `inboxIds` se archivan tras vincularlos. Solo aplica a `inboxIds`."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Vincular un upload",
									"value": {
										"uploadIds": [
											"upl_8a2c1234-1234-1234-1234-123456789012"
										]
									}
								},
								"fromInbox": {
									"summary": "Vincular un item de la bandeja",
									"value": {
										"inboxIds": [
											"tas_4b5dbc2d-3060-4fd1-92d4-69a054c7d4a2"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Nómina con los nuevos adjuntos vinculados",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/PayrollResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"get": {
				"tags": [
					"Nóminas"
				],
				"summary": "Listar adjuntos de una nómina",
				"operationId": "getPayrollAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la nómina. Formado por el prefjo \"par_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de adjuntos de una nómina",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "getPayrollAttachmentsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Attachment"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/payrolls/{id}/attachments/{attachmentIndex}": {
			"delete": {
				"tags": [
					"Nóminas"
				],
				"summary": "Eliminar adjunto de una nómina",
				"description": "Elimina el adjunto en la posición indicada. Los índices son 0-based. El binario en S3 no se elimina para preservar URLs ya distribuidas.",
				"operationId": "deletePayrollAttachment",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  de la nómina. Formado por el prefjo \"par_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "attachmentIndex",
						"in": "path",
						"required": true,
						"schema": {
							"type": "integer",
							"minimum": 0
						},
						"description": "Índice (0-based) del adjunto a eliminar."
					}
				],
				"responses": {
					"200": {
						"description": "Adjunto eliminado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "deletePayrollAttachmentResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/banks": {
			"get": {
				"tags": [
					"Bancos"
				],
				"summary": "Lista de bancos",
				"description": "Devuelve una lista de los bancos y cuentas de tesorería disponibles en la empresa.\n\nCon el parámetro `related` cada banco puede incluir su saldo contable, el saldo según la entidad, el estado del enlace y los movimientos pendientes de conciliar.",
				"operationId": "getBanks",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "currency",
						"in": "query",
						"description": "Moneda del banco (Formato ISO 4217)",
						"schema": {
							"type": "string",
							"minLength": 3,
							"maxLength": 3
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales del banco en `related`. Se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* balance: Devuelve en related.balance el saldo contable del banco (el de la pantalla de bancos). Con `balanceDate`, el saldo al cierre de ese día\n* linkedBalance: Devuelve en related.linkedBalance el saldo según la entidad en el último movimiento sincronizado, con su fecha y la de la última sincronización, o null si no hay\n* link: Devuelve en related.link el estado de la conexión automática con el banco (estado, entidad, sincronización, acción pendiente, último intento)\n* statements: Devuelve en related.statements los movimientos pendientes de conciliar y la fecha del último movimiento",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"balance",
									"linkedBalance",
									"link",
									"statements"
								]
							}
						}
					},
					{
						"name": "balanceDate",
						"in": "query",
						"description": "Fecha de corte del saldo contable (AAAA-MM-DD). Solo tiene efecto con `related=balance`: el saldo incluye los apuntes con fecha hasta ese día inclusive, y `related.balance.date` la devuelve. Sin ella el saldo incluye todos los apuntes, también los de fecha futura, como la pantalla de bancos",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por título y luego por fecha de creación descendente utiliza los parámetros 'sortBy=title&sortBy=-creationDate'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* title: Título del banco\n* currency: Moneda del banco\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"title",
									"-title",
									"currency",
									"-currency",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					}
				],
				"responses": {
					"200": {
						"description": "Lista de bancos",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetBanksResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/BankResponse"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"banks:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/banks/{id}": {
			"get": {
				"tags": [
					"Bancos"
				],
				"summary": "Obtener un banco",
				"description": "Obtiene un banco o cuenta de tesorería de la empresa, con la misma forma que cada elemento del listado.\n\nCon el parámetro `related` incluye su saldo contable, el saldo según la entidad, el estado del enlace y los movimientos pendientes de conciliar.",
				"operationId": "getBank",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del banco o cuenta de tesorería. Formado por el prefijo \"ban_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales del banco en `related`. Se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* balance: Devuelve en related.balance el saldo contable del banco (el de la pantalla de bancos). Con `balanceDate`, el saldo al cierre de ese día\n* linkedBalance: Devuelve en related.linkedBalance el saldo según la entidad en el último movimiento sincronizado, con su fecha y la de la última sincronización, o null si no hay\n* link: Devuelve en related.link el estado de la conexión automática con el banco (estado, entidad, sincronización, acción pendiente, último intento)\n* statements: Devuelve en related.statements los movimientos pendientes de conciliar y la fecha del último movimiento",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"balance",
									"linkedBalance",
									"link",
									"statements"
								]
							}
						}
					},
					{
						"name": "balanceDate",
						"in": "query",
						"description": "Fecha de corte del saldo contable (AAAA-MM-DD). Solo tiene efecto con `related=balance`: el saldo incluye los apuntes con fecha hasta ese día inclusive, y `related.balance.date` la devuelve. Sin ella el saldo incluye todos los apuntes, también los de fecha futura, como la pantalla de bancos",
						"schema": {
							"type": "string",
							"format": "date"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido del banco solicitado",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/BankResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"banks:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/statements": {
			"get": {
				"tags": [
					"Extractos bancarios"
				],
				"summary": "Lista de extractos bancarios",
				"description": "Devuelve una lista de extractos bancarios (movimientos de banco) con sus estados de conciliación.\n\nLos extractos bancarios son los movimientos importados o sincronizados de las cuentas bancarias de la empresa. Cada extracto puede estar en uno de los siguientes estados:\n\n* **pending**: Pendiente de conciliar\n* **reconciled**: Conciliado con un documento contable\n* **ignored**: Marcado como ignorado por el usuario",
				"operationId": "getStatements",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima de la operación en formato YYYY-MM-DD",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima de la operación en formato YYYY-MM-DD",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "bank",
						"in": "query",
						"description": "Identificador del banco para filtrar los extractos",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "currency",
						"in": "query",
						"description": "Moneda del extracto bancario (Formato ISO 4217)",
						"schema": {
							"type": "string",
							"minLength": 3,
							"maxLength": 3
						}
					},
					{
						"name": "minAmount",
						"in": "query",
						"description": "Importe mínimo del movimiento",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "maxAmount",
						"in": "query",
						"description": "Importe máximo del movimiento",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "matchedDocument",
						"in": "query",
						"description": "Identificador del asiento contable con el que está conciliado el extracto.\n\nDevuelve únicamente extractos realmente conciliados con ese asiento. Un extracto cuyo asiento se haya archivado vuelve a estar pendiente y no se devuelve, igual que su `matchedDocument` se responde como null en el listado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "state",
						"in": "query",
						"description": "Estado de conciliación del extracto:\n* pending: Pendiente de conciliar\n* reconciled: Conciliado\n* ignored: Ignorado",
						"schema": {
							"type": "string",
							"enum": [
								"pending",
								"reconciled",
								"ignored"
							]
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados.\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante para que el orden sea descendente.\n\nPor ejemplo, para ordenar por fecha descendente y luego por importe: 'sortBy=-date&sortBy=amount'\n\nOpciones disponibles:\n\n* date: Fecha de la operación\n* amount: Importe del movimiento\n* currency: Moneda del movimiento\n* state: Estado de conciliación\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date",
									"amount",
									"-amount",
									"currency",
									"-currency",
									"state",
									"-state",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					}
				],
				"responses": {
					"200": {
						"description": "Lista de extractos bancarios",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetStatementsResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/StatementListItem"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"statements:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/statements/{id}": {
			"get": {
				"tags": [
					"Extractos bancarios"
				],
				"summary": "Obtener un extracto bancario",
				"description": "Obtiene el detalle de un extracto bancario",
				"operationId": "getStatement",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del extracto bancario. Formado por el prefijo \"sta_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Detalle del extracto bancario",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/StatementResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"statements:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/statements/{id}/reconciliation": {
			"post": {
				"tags": [
					"Extractos bancarios"
				],
				"summary": "Conciliar extracto bancario creando un nuevo asiento contable",
				"description": "Concilia un extracto bancario creando un nuevo asiento contable (transaction) en la misma operación. El asiento se crea con la fecha del extracto bancario y queda vinculado a él.\n\nHay dos formas de indicar el asiento, excluyentes entre sí:\n\n- **`document`**: identificador de la factura de venta, compra o nómina que el movimiento cobra o paga. La API construye el asiento como un cobro o pago del documento: el apunte del banco lleva el importe del movimiento en la moneda del banco y su contravalor en la moneda de la empresa, el apunte del documento salda el documento (o el importe que indiques en `amount`) y la diferencia entre ambos, si la hay, va a la cuenta de diferencias positivas o negativas de cambio de la configuración contable. Es la forma recomendada, y la más sencilla cuando el banco, el documento o ambos están en una moneda distinta de la de la empresa. Si el documento y el banco están en la misma moneda, el importe aplicado al documento es el del movimiento (si no coincide con el pendiente, el documento queda con saldo). Si están en monedas distintas, se salda el pendiente del documento salvo que indiques `amount` (importe en la moneda del documento, para cobros o pagos parciales). El sentido del movimiento (ingreso o cargo) debe corresponder al saldo pendiente del documento.\n- **`lines`**: los apuntes contables completos del asiento, para cualquier otro caso. Debe incluir un apunte en la cuenta del banco con `document` igual al identificador del banco y en el sentido del movimiento (debe en un ingreso, haber en un cargo), y los apuntes deben cuadrar.\n\nSi el extracto ya está conciliado con un asiento activo, la operación fallará indicando el identificador del asiento existente. Si el asiento previamente conciliado está archivado, se permite re-conciliar.",
				"operationId": "reconcileStatementWithNewTransaction",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del extracto bancario. Formado por el prefijo \"sta_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Datos para la creación del asiento contable",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "ReconcileWithNewTransactionRequest",
								"additionalProperties": false,
								"properties": {
									"document": {
										"type": "string",
										"description": "Identificador de la factura de venta (inv_), compra (bil_) o nómina (par_) que el movimiento cobra o paga: la API construye el asiento. Excluyente con 'lines'"
									},
									"amount": {
										"type": "number",
										"description": "Solo con 'document' y cuando el documento y el banco están en monedas distintas: importe aplicado al documento, en la moneda del documento, para un cobro o pago parcial. Por defecto se salda el pendiente del documento"
									},
									"lines": {
										"type": "array",
										"description": "Apuntes contables del asiento a crear, tal cual se guardarán. Excluyente con 'document'",
										"items": {
											"$ref": "#/components/schemas/AccountingLine"
										},
										"minItems": 1
									},
									"title": {
										"type": "string",
										"description": "Título del asiento contable. Si no se indica, se usa el concepto del extracto bancario"
									}
								}
							},
							"examples": {
								"reconcileDocument": {
									"summary": "Conciliar con el documento que cobra o paga (la API construye el asiento)",
									"value": {
										"document": "bil_10000000-0000-4000-8000-000000000000"
									}
								},
								"reconcileReceive": {
									"summary": "Conciliar un ingreso con los apuntes del asiento (cobro de factura de venta)",
									"value": {
										"lines": [
											{
												"account": "572000",
												"document": "ban_10000000-0000-4000-8000-000000000000",
												"debit": 121,
												"credit": null,
												"currencyDebit": 121,
												"currencyCredit": null,
												"currency": "EUR"
											},
											{
												"account": "430000",
												"document": "inv_10000000-0000-4000-8000-000000000000",
												"debit": null,
												"credit": 121,
												"currencyDebit": null,
												"currencyCredit": 121,
												"currency": "EUR"
											}
										]
									}
								},
								"reconcileSend": {
									"summary": "Conciliar un cargo con los apuntes del asiento (pago de factura de compra)",
									"value": {
										"lines": [
											{
												"account": "572000",
												"document": "ban_10000000-0000-4000-8000-000000000000",
												"debit": null,
												"credit": 121,
												"currencyDebit": null,
												"currencyCredit": 121,
												"currency": "EUR"
											},
											{
												"account": "400000",
												"document": "bil_10000000-0000-4000-8000-000000000000",
												"debit": 121,
												"credit": null,
												"currencyDebit": 121,
												"currencyCredit": null,
												"currency": "EUR"
											}
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la conciliación con el asiento contable creado",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ReconcileWithNewTransactionResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"statements:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Extractos bancarios"
				],
				"summary": "Conciliar extracto bancario con asiento contable existente",
				"description": "Marca un extracto bancario como conciliado vinculándolo con un asiento contable (transaction) existente.\n\nLa conciliación vincula el movimiento bancario con el asiento contable indicado en `transactionId`. Para deshacer la conciliación utiliza la operación DELETE sobre este mismo recurso.",
				"operationId": "reconcileStatement",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del extracto bancario. Formado por el prefijo \"sta_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Datos de la conciliación",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "ReconcileStatementRequest",
								"required": [
									"transactionId"
								],
								"additionalProperties": false,
								"properties": {
									"transactionId": {
										"type": "string",
										"description": "Identificador del asiento contable (transaction) con el que conciliar el extracto bancario"
									}
								}
							},
							"examples": {
								"reconcileWithTransaction": {
									"summary": "Conciliar con un asiento contable de cobro",
									"value": {
										"transactionId": "tra_30000000-0000-4000-8000-000000000000"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la conciliación",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ReconcileStatementResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"statements:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Extractos bancarios"
				],
				"summary": "Desconciliar extracto bancario",
				"description": "Elimina la conciliación de un extracto bancario, devolviendo su estado a pendiente.\n\nSi se indica el parámetro `deleteTransaction=true`, además de desconciliar se archiva el asiento contable (transaction) asociado. En este caso el extracto debe estar conciliado con un asiento activo (no archivado) y el asiento no debe estar bloqueado por la fecha de cierre contable.",
				"operationId": "unreconcileStatement",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del extracto bancario. Formado por el prefijo \"sta_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "deleteTransaction",
						"in": "query",
						"description": "Si es `true`, además de desconciliar se archiva el asiento contable asociado",
						"schema": {
							"type": "boolean"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Resultado de la desconciliación",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/UnreconcileStatementResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"statements:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/paymentMethods": {
			"get": {
				"tags": [
					"Métodos de pago"
				],
				"summary": "Lista de métodos de pago",
				"description": "Devuelve una lista de los métodos de pago disponibles en la empresa.\n\nLos métodos de pago pueden ser globales o particulares de un cliente (cobros mediante recibo domiciliado o pagos mediante transferencia bancaria)",
				"operationId": "getPaymentMethods",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "contact",
						"in": "query",
						"description": "Id del contacto para el que se obtendrán los métodos de pago.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "includeGlobal",
						"in": "query",
						"description": "Indica si quieres incluir en los resultados los métodos de pago globales (asignables a todos los clientes)",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el caracter - delante par que el orden sea descendente.\n\nPor ejemplo, para ordenar de forma descendente por título y luego por fecha de creación descendente utiliza los parámetros 'sortBy=title&sortBy=-creationDate'\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* title: Título del banco\n* creationDate: Fecha de creación en el sistema\n* modificationDate: Fecha de última modificación en el sistema",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"title",
									"-title",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					}
				],
				"responses": {
					"200": {
						"description": "Lista de métodos de pago",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPaymentMethodsResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/PaymentMethodResponse"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"paymentMethods:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Métodos de pago"
				],
				"summary": "Crear método de pago",
				"description": "Crea un nuevo método de pago",
				"operationId": "createPaymentMethod",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del método de pago a crear",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreatePaymentMethodRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/PaymentMethodWrite"
									}
								}
							},
							"examples": {
								"transfer": {
									"summary": "Método de pago global para documentos de venta",
									"value": {
										"content": {
											"type": "paymentMethod",
											"main": {
												"subtype": "manual",
												"title": "Pago por transferencia",
												"bank": "ban_10000000-0000-4000-8000-000000000000",
												"details": {}
											}
										}
									}
								},
								"directDebit": {
									"summary": "Mandato para cobro por recibo domiciliado a clientes",
									"value": {
										"content": {
											"type": "paymentMethod",
											"main": {
												"subtype": "sepaDirectDebit",
												"title": "Recibo domiciliado",
												"direction": "receive",
												"contact": "con_10000000-0000-4000-8000-000000000000",
												"details": {
													"id": "MANDATO_01",
													"signatureDate": "2023-04-10",
													"instrument": "CORE",
													"recurrent": true,
													"iban": "ES3011112222003333333333"
												}
											}
										}
									}
								},
								"sepaCreditTransfer": {
									"summary": "Pago por transferencia para proveedores",
									"value": {
										"content": {
											"type": "paymentMethod",
											"main": {
												"subtype": "sepaCreditTransfer",
												"title": "Transferencia SEPA",
												"direction": "send",
												"contact": "con_20000000-0000-4000-8000-000000000000",
												"details": {
													"iban": "ES9122223333304444444444"
												}
											}
										}
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la creación del método de pago",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreatePaymentMethodResponse",
									"required": [
										"content",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/PaymentMethod"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"paymentMethods:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/paymentMethods/{id}": {
			"get": {
				"tags": [
					"Métodos de pago"
				],
				"summary": "Obtener un método de pago",
				"description": "Obtiene el contenido de un método de pago",
				"operationId": "getPaymentMethod",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del método de pago. Formado por el prefjo \"pam_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Contenido del método de pago solicitado",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/PaymentMethodResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"paymentMethods:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Métodos de pago"
				],
				"summary": "Actualizar método de pago",
				"description": "Actualiza un método de pago",
				"operationId": "updatePaymentMethod",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del método de pago. Formado por el prefjo \"pam_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"description": "Contenido del método de pago a actualizar",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdatePaymentMethodRequest",
								"required": [
									"content"
								],
								"properties": {
									"content": {
										"$ref": "#/components/schemas/PaymentMethodWrite"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la actualización del método de pago",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdatePaymentMethodResponse",
									"required": [
										"content",
										"creationDate",
										"modificationDate"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/PaymentMethod"
										},
										"creationDate": {
											"$ref": "#/components/schemas/CreationDate"
										},
										"modificationDate": {
											"$ref": "#/components/schemas/ModificationDate"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"paymentMethods:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Métodos de pago"
				],
				"summary": "Borrar método de pago",
				"description": "Elimina un método de pago existente",
				"operationId": "deletePaymentMethod",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del método de pago. Formado por el prefjo \"pam_\"  y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"$ref": "#/components/responses/DeleteResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"paymentMethods:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/journal": {
			"get": {
				"tags": [
					"Contabilidad"
				],
				"summary": "Diario contable",
				"description": "Devuelve una lista de movimientos del diario contable de la empresa",
				"operationId": "getJournal",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima del apunte en formato YYYY-MM-DD.\n\nSe incluirán en los resultados facturas con fecha mayor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima del apunte en formato YYYY-MM-DD.\n\nSe incluirán en los resultados facturas con fecha menor o igual al valor indicado",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "account",
						"in": "query",
						"description": "Cuenta contable completa o prefijo de cuenta. Acepta entre 1 y 6 dígitos y devuelve los movimientos de todas las cuentas que empiecen por el valor indicado.\n\nPor ejemplo, `6` incluye todas las cuentas de gastos, `64` las de personal y `700000` únicamente la cuenta completa de ventas 700000.",
						"schema": {
							"type": "string",
							"pattern": "^[0-9]{1,6}$"
						}
					},
					{
						"name": "id",
						"in": "query",
						"description": "Identificador del documento que origina los apuntes (asiento contable, factura, gasto, nómina o remesa) para obtener todos los apuntes de ese documento.\n\nNo debe confundirse con `document`, que se refiere al documento al que se imputa cada apunte.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "document",
						"in": "query",
						"description": "Identificador del documento que actúa como subcuenta para obtener solo apuntes que afecten a su saldo",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "journalPriority",
						"in": "query",
						"description": "Indica un valor para obtener solo asientos del diario según su tipo",
						"schema": {
							"$ref": "#/components/schemas/JournalPriority"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener el documento que contiene al apunte para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener el documento que contiene al apunte para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo apuntes producidos por documentos que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados\n\nEstán disponibles las siguientes opciones de ordenación:\n\n* date: Fecha del asiento",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Permite obtener datos adicionales relacionados con el registro del diario, se pueden indicar tantos valores como sea necesario entre los siguientes:\n\n* idAccounting: Asiento contable completo del documento que contiene este apunte\n* tags: Devuelve en el atributo \"tags\" las etiquetas asociadas al documento que origina el apunte\n* currency: Devuelve el contravalor en moneda original de los asientos en moneda distinta de EUR (atributos \"currency\", \"currencyCredit\" y \"currencyDebit\"). Disponible solo en empresas con el soporte multimoneda activado",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"tags",
									"currency",
									"idAccounting"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de apuntes del diario",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetJournalResponse",
									"required": [
										"pagination",
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"type": "object",
												"additionalProperties": false,
												"required": [
													"id",
													"idType",
													"idTitle",
													"idLineIndex",
													"debit",
													"credit",
													"account",
													"accountTitle"
												],
												"properties": {
													"id": {
														"type": "string",
														"description": "Identificador del documento que contiene el apunte"
													},
													"idType": {
														"type": "string",
														"description": "Tipo del documento que contiene el apunte.\n                                \nValores posibles:\n\n* bill: Factura de compra o ticket\n* invoice: Factura de vent\n* payroll: Nómina\n* payment: Remesa bancaria (cobro o pago)\n* taxes: Modelo de impuestos\n* transaction: Asiento contable",
														"enum": [
															"bill",
															"invoice",
															"payroll",
															"payment",
															"taxes",
															"transaction"
														]
													},
													"idTitle": {
														"type": "string",
														"description": "Título del documento que contiene el apunte"
													},
													"idSummary": {
														"type": "string",
														"description": "Resument/descripción del documento que contiene el apunte. Disponible solo para facturas de venta, compras y nóminas"
													},
													"idLineIndex": {
														"type": "integer",
														"description": "Número de apunte dentro del asiento del documento"
													},
													"idAccounting": {
														"description": "Asiento contable completo del documento que contiene el apunte. Solo se incluye en la respuesta si se solicita con related=idAccounting",
														"allOf": [
															{
																"$ref": "#/components/schemas/Accounting"
															}
														]
													},
													"date": {
														"type": "string",
														"format": "date",
														"description": "Fecha del apunte"
													},
													"debit": {
														"type": "number",
														"description": "Importe anotado en el DEBE en EUR"
													},
													"credit": {
														"type": "number",
														"description": "Importe anotado en el HABER en EUR"
													},
													"currency": {
														"type": "string",
														"description": "Moneda original del apunte (Formato ISO 4217). Disponible solo para empresas con el soporte multimoneda activo"
													},
													"currencyDebit": {
														"type": "number",
														"description": "Importe anotado en el DEBE en la moneda original del asiento. Disponible solo para empresas con el soporte multimoneda activo"
													},
													"currencyCredit": {
														"type": "number",
														"description": "Importe anotado en el HABER en la moneda original del asiento. Disponible solo para empresas con el soporte multimoneda activo"
													},
													"account": {
														"$ref": "#/components/schemas/AccountCode"
													},
													"accountTitle": {
														"type": "string",
														"description": "Nombre de la cuenta contable en el plan de cuentas de la empresa"
													},
													"document": {
														"type": "string",
														"description": "Identificador del documento que actúa como subcuenta (si existe alguno)"
													},
													"documentType": {
														"type": "string",
														"description": "Tipo del documento que actúa como subcuenta (si existe alguno).\n                                \nValores posibles:\n\n* bill: Factura de compra o ticket\n* invoice: Factura de vent\n* payroll: Nómina\n* payment: Remesa bancaria (cobro o pago)\n* transaction: Asiento contable\n* bank: Banco\n* contact: Contacto\n* product: Producto",
														"enum": [
															"bill",
															"invoice",
															"payroll",
															"payment",
															"transaction",
															"bank",
															"contact",
															"product"
														]
													},
													"documentTitle": {
														"type": "string",
														"description": "Título del documento que actúa como subcuenta (si existe alguno)"
													},
													"journalPriority": {
														"$ref": "#/components/schemas/JournalPriority"
													},
													"tags": {
														"$ref": "#/components/schemas/Tags"
													}
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"accounting:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/reports/resultsSummary": {
			"get": {
				"tags": [
					"Informes"
				],
				"summary": "Resumen de resultados",
				"description": "Ingresos, gastos y beneficio de un periodo, separados por su origen: facturas, gastos, nóminas, amortizaciones, diferencias de cambio y otros. Son las mismas cifras que las tarjetas de Ingresos, Gastos y Beneficio del panel y el informe «Resumen de resultados» de la web, y están disponibles en todos los planes.\n\nLos importes son los apuntes de los grupos 6 y 7 del periodo sin el asiento de regularización. Coinciden con sumas y saldos de esos grupos y con el resultado de pérdidas y ganancias excluyendo la regularización.\n\nCon `compare` o `breakdown` el informe tiene una columna por periodo. Para ver los documentos que componen una cifra, usa [el detalle del resumen](#tag/Informes/operation/getResultsDetail) con la categoría y las fechas de su columna.",
				"operationId": "getResultsSummary",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "startDate",
						"in": "query",
						"description": "Primer día del periodo en formato YYYY-MM-DD. Por defecto, el 1 de enero del año en curso.\n\nEl periodo admite como máximo 5 años.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "endDate",
						"in": "query",
						"description": "Último día del periodo en formato YYYY-MM-DD, incluido. Por defecto, el 31 de diciembre del año en curso.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "compare",
						"in": "query",
						"description": "Añade una columna con un periodo de referencia. No se combina con `breakdown`.\n\n* none: Sin comparativa (por defecto)\n* previousPeriod: El periodo anterior de la misma duración\n* previousYear: El mismo periodo del año anterior",
						"schema": {
							"type": "string",
							"enum": [
								"none",
								"previousPeriod",
								"previousYear"
							]
						}
					},
					{
						"name": "breakdown",
						"in": "query",
						"description": "Divide el periodo en meses, trimestres o años naturales, con una columna por tramo y como máximo 24. No se combina con `compare`.\n\n* none: Una sola columna (por defecto)\n* month: Por meses\n* quarter: Por trimestres\n* year: Por años",
						"schema": {
							"type": "string",
							"enum": [
								"none",
								"month",
								"quarter",
								"year"
							]
						}
					},
					{
						"name": "difference",
						"in": "query",
						"description": "Con `compare`, añade la columna `difference`: periodo menos referencia.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "variance",
						"in": "query",
						"description": "Con `compare`, añade la columna `variance`: variación sobre la referencia, como fracción (`0.2` es un 20 %). Vale `null` si la referencia es cero.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "total",
						"in": "query",
						"description": "Con `breakdown`, añade la columna `total` con el periodo completo.",
						"schema": {
							"type": "boolean"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Resumen de resultados del periodo",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ResultsSummaryReport"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"accounting:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/reports/resultsDetail": {
			"get": {
				"tags": [
					"Informes"
				],
				"summary": "Detalle del resumen de resultados",
				"description": "Documentos que componen una cifra del [resumen de resultados](#tag/Informes/operation/getResultsSummary), con el importe que aporta cada uno, de más antiguo a más reciente. Con la categoría y las fechas de una columna del resumen, la suma de `amount` de todas las páginas es el importe de esa celda.\n\nLos apuntes sin documento, como las liquidaciones de impuestos, aparecen con su propio identificador y sin tipo de documento.",
				"operationId": "getResultsDetail",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "category",
						"in": "query",
						"description": "Obligatorio. Origen de los importes:\n\n* invoices: Ventas facturadas\n* currencyGains: Diferencias de cambio a favor\n* otherIncome: Otros ingresos\n* bills: Compras y gastos\n* payrolls: Nóminas\n* depreciation: Amortizaciones\n* currencyLosses: Diferencias de cambio en contra\n* otherExpenses: Otros gastos",
						"schema": {
							"type": "string",
							"enum": [
								"invoices",
								"currencyGains",
								"otherIncome",
								"bills",
								"payrolls",
								"depreciation",
								"currencyLosses",
								"otherExpenses"
							]
						}
					},
					{
						"name": "startDate",
						"in": "query",
						"description": "Primer día del periodo en formato YYYY-MM-DD. Por defecto, el 1 de enero del año en curso.\n\nEl periodo admite como máximo 5 años.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "endDate",
						"in": "query",
						"description": "Último día del periodo en formato YYYY-MM-DD, incluido. Por defecto, el 31 de diciembre del año en curso.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					}
				],
				"responses": {
					"200": {
						"description": "Documentos de una categoría del resumen de resultados",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ResultsDetailReport"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"accounting:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/reports/profitLoss": {
			"get": {
				"tags": [
					"Informes"
				],
				"summary": "Pérdidas y ganancias",
				"description": "Cuenta de pérdidas y ganancias según el modelo oficial del Plan General Contable (pymes, o entidades sin fines lucrativos según la empresa), con las mismas cifras y opciones que el informe de la web.\n\nCada fila tiene un identificador estable: el epígrafe del modelo (`A_1`, `D`...), ampliado en los grupos de cuentas (`A_1/700`) y en el detalle por cuenta y tercero.\n\nRequiere el módulo de Contabilidad: sin él responde `403` con `plan_limit_exceeded` y `hint.features: [\"fullAccounting\"]`. El perfil de una aplicación conectada indica en `accountingModule` si la empresa lo tiene.",
				"operationId": "getProfitLoss",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "startDate",
						"in": "query",
						"description": "Primer día del periodo en formato YYYY-MM-DD. Por defecto, el 1 de enero del año en curso.\n\nEl periodo admite como máximo 5 años.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "endDate",
						"in": "query",
						"description": "Último día del periodo en formato YYYY-MM-DD, incluido. Por defecto, el 31 de diciembre del año en curso.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "compare",
						"in": "query",
						"description": "Añade una columna con un periodo de referencia. No se combina con `breakdown`.\n\n* none: Sin comparativa (por defecto)\n* previousPeriod: El periodo anterior de la misma duración\n* previousYear: El mismo periodo del año anterior",
						"schema": {
							"type": "string",
							"enum": [
								"none",
								"previousPeriod",
								"previousYear"
							]
						}
					},
					{
						"name": "breakdown",
						"in": "query",
						"description": "Divide el periodo en meses, trimestres o años naturales, con una columna por tramo y como máximo 24. No se combina con `compare`.\n\n* none: Una sola columna (por defecto)\n* month: Por meses\n* quarter: Por trimestres\n* year: Por años",
						"schema": {
							"type": "string",
							"enum": [
								"none",
								"month",
								"quarter",
								"year"
							]
						}
					},
					{
						"name": "difference",
						"in": "query",
						"description": "Con `compare`, añade la columna `difference`: periodo menos referencia.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "variance",
						"in": "query",
						"description": "Con `compare`, añade la columna `variance`: variación sobre la referencia, como fracción (`0.2` es un 20 %). Vale `null` si la referencia es cero.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "total",
						"in": "query",
						"description": "Con `breakdown`, añade la columna `total` con el periodo completo.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "revenueShare",
						"in": "query",
						"description": "Añade, tras cada columna de periodo, otra con el peso de cada fila sobre el importe neto de la cifra de negocios, como fracción. Su `id` es el de la columna seguido de `_share`.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "detail",
						"in": "query",
						"description": "Nivel de detalle, el mismo que en la web:\n\n* summary: Solo los epígrafes del modelo oficial\n* accounts: Además, una fila por grupo de cuentas de cada epígrafe (por defecto)\n* full: Además, una fila por cuenta y tercero (cliente, proveedor, banco o producto)",
						"schema": {
							"type": "string",
							"enum": [
								"summary",
								"accounts",
								"full"
							]
						}
					},
					{
						"name": "includeClosure",
						"in": "query",
						"description": "Incluye los asientos de regularización y de cierre fechados el último día del periodo. Por defecto se excluyen, para ver el periodo como si no se hubiera cerrado.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "excludeRevenueClearing",
						"in": "query",
						"description": "Excluye el asiento de regularización de ingresos y gastos en todo el periodo, aunque se incluya el cierre.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Solo los apuntes de documentos que tienen todas estas etiquetas. Se puede repetir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Pérdidas y ganancias del periodo",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/FinancialReport"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"accounting:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/reports/balanceSheet": {
			"get": {
				"tags": [
					"Informes"
				],
				"summary": "Balance de situación",
				"description": "Balance de situación según el modelo oficial del Plan General Contable (pymes, o entidades sin fines lucrativos según la empresa), con las mismas cifras y opciones que el informe de la web. Cada columna es el saldo acumulado a una fecha.\n\nEl resultado del ejercicio se calcula desde la cuenta de pérdidas y ganancias. Si el activo no coincide con el patrimonio neto y el pasivo, aparece la fila `imbalance` y el diagnóstico del mismo nombre.\n\nRequiere el módulo de Contabilidad: sin él responde `403` con `plan_limit_exceeded` y `hint.features: [\"fullAccounting\"]`. El perfil de una aplicación conectada indica en `accountingModule` si la empresa lo tiene.",
				"operationId": "getBalanceSheet",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "date",
						"in": "query",
						"description": "Fecha del saldo en formato YYYY-MM-DD. Por defecto, el 31 de diciembre del año en curso.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "startDate",
						"in": "query",
						"description": "Primer día del periodo en formato YYYY-MM-DD, para `breakdown` y `compare=previousPeriod`. Por defecto, el 1 de enero del año de `date`. El periodo admite como máximo 5 años.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "compare",
						"in": "query",
						"description": "Añade una columna con el saldo en una fecha de referencia. No se combina con `breakdown`.\n\n* none: Sin comparativa (por defecto)\n* previousPeriod: Al final del periodo anterior: el día antes de `startDate` (el 31 de diciembre del año anterior si no se indica)\n* previousYear: En la misma fecha del año anterior",
						"schema": {
							"type": "string",
							"enum": [
								"none",
								"previousPeriod",
								"previousYear"
							]
						}
					},
					{
						"name": "breakdown",
						"in": "query",
						"description": "Saldos al final de cada mes, trimestre o año natural del periodo, con una columna por tramo y como máximo 24. No se combina con `compare`.\n\n* none: Una sola columna (por defecto)\n* month: Por meses\n* quarter: Por trimestres\n* year: Por años",
						"schema": {
							"type": "string",
							"enum": [
								"none",
								"month",
								"quarter",
								"year"
							]
						}
					},
					{
						"name": "difference",
						"in": "query",
						"description": "Con `compare`, añade la columna `difference`: periodo menos referencia.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "variance",
						"in": "query",
						"description": "Con `compare`, añade la columna `variance`: variación sobre la referencia, como fracción (`0.2` es un 20 %). Vale `null` si la referencia es cero.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "detail",
						"in": "query",
						"description": "Nivel de detalle, el mismo que en la web:\n\n* summary: Solo los epígrafes del modelo oficial\n* accounts: Además, una fila por grupo de cuentas de cada epígrafe (por defecto)\n* full: Además, una fila por cuenta y tercero (cliente, proveedor, banco o producto)",
						"schema": {
							"type": "string",
							"enum": [
								"summary",
								"accounts",
								"full"
							]
						}
					},
					{
						"name": "includeClosure",
						"in": "query",
						"description": "Incluye los asientos de regularización y de cierre fechados el último día del periodo. Por defecto se excluyen, para ver el periodo como si no se hubiera cerrado.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Solo los apuntes de documentos que tienen todas estas etiquetas. Se puede repetir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Balance de situación a la fecha",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/FinancialReport"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"accounting:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/reports/trialBalance": {
			"get": {
				"tags": [
					"Informes"
				],
				"summary": "Sumas y saldos",
				"description": "Balance de sumas y saldos: saldo anterior, debe, haber y saldo final de cada cuenta en el periodo, con las mismas cifras y opciones que el informe de la web. El saldo anterior es todo lo anterior a `startDate`, con el asiento de apertura de ese día.\n\nLa paginación se aplica a las filas ya agrupadas; `totals` es el total del informe completo.\n\nRequiere el módulo de Contabilidad: sin él responde `403` con `plan_limit_exceeded` y `hint.features: [\"fullAccounting\"]`. El perfil de una aplicación conectada indica en `accountingModule` si la empresa lo tiene.",
				"operationId": "getTrialBalance",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "startDate",
						"in": "query",
						"description": "Primer día del periodo en formato YYYY-MM-DD. Por defecto, el 1 de enero del año en curso.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "endDate",
						"in": "query",
						"description": "Último día del periodo en formato YYYY-MM-DD, incluido. Por defecto, el 31 de diciembre del año en curso.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "account",
						"in": "query",
						"description": "Cuenta contable completa o prefijo de cuenta: `43` incluye todas las cuentas de clientes y `430000` solo esa cuenta.",
						"schema": {
							"type": "string",
							"pattern": "^[0-9]{1,12}$"
						}
					},
					{
						"name": "groups",
						"in": "query",
						"description": "Añade filas de subtotal por los primeros 1, 2 o 3 dígitos de la cuenta. Se puede repetir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "integer",
								"enum": [
									1,
									2,
									3
								]
							}
						}
					},
					{
						"name": "thirdParty",
						"in": "query",
						"description": "Solo los apuntes de este tercero (contacto, producto o banco), con el criterio del balance y de pérdidas y ganancias: sus propios apuntes y los de sus documentos.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "thirdPartyDetail",
						"in": "query",
						"description": "Añade bajo cada cuenta una fila por tercero. Necesita `thirdParty`: el detalle de todos los terceros de una cuenta puede tardar decenas de segundos en empresas con miles de clientes.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "showCurrency",
						"in": "query",
						"description": "Separa cada cuenta por moneda y añade `currencyAmounts` con los importes en la moneda original. Solo tiene efecto en empresas con multimoneda.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "excludeBalance0",
						"in": "query",
						"description": "Omite las filas con saldo final cero.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "includeClosure",
						"in": "query",
						"description": "Incluye los asientos de regularización y de cierre fechados el último día del periodo. Por defecto se excluyen, para ver el periodo como si no se hubiera cerrado.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "excludeRevenueClearing",
						"in": "query",
						"description": "Excluye el asiento de regularización de ingresos y gastos en todo el periodo, aunque se incluya el cierre.",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Solo los apuntes de documentos que tienen todas estas etiquetas. Se puede repetir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					}
				],
				"responses": {
					"200": {
						"description": "Sumas y saldos del periodo",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/TrialBalanceReport"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"accounting:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/taxDeclarations": {
			"get": {
				"tags": [
					"Declaraciones de impuestos"
				],
				"summary": "Lista de modelos de impuestos",
				"description": "Devuelve los modelos de impuestos (declaraciones) que el usuario ha generado y guardado en FacturaDirecta, del más reciente al más antiguo. Cada elemento lleva el sobre del modelo: número de modelo, periodo, resultado, estado y fichero de presentación disponible. Las casillas solo se incluyen con `related=boxes`, y los registros por tercero de las informativas solo en el detalle.\n\nLa API no genera ni presenta modelos: solo lee los que existen.",
				"operationId": "getTaxDeclarations",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "form",
						"in": "query",
						"description": "Número de modelo. Se pueden indicar varios.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"111",
									"115",
									"130",
									"180",
									"190",
									"202",
									"303",
									"347",
									"349",
									"390"
								]
							}
						}
					},
					{
						"name": "kind",
						"in": "query",
						"description": "Tipo de modelo: autoliquidaciones (`selfAssessment`) o declaraciones informativas (`informative`).",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"selfAssessment",
									"informative"
								]
							}
						}
					},
					{
						"name": "fiscalYear",
						"in": "query",
						"description": "Ejercicio.",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "fiscalPeriod",
						"in": "query",
						"description": "Periodo: trimestre (`1T`…`4T`), mes (`01`…`12`) o pago fraccionado del 202 (`1P`…`3P`). Se pueden indicar varios. Los modelos anuales no tienen periodo y no salen al filtrar por él.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"1T",
									"2T",
									"3T",
									"4T",
									"01",
									"02",
									"03",
									"04",
									"05",
									"06",
									"07",
									"08",
									"09",
									"10",
									"11",
									"12",
									"1P",
									"2P",
									"3P"
								]
							}
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"description": "Fecha mínima del modelo (el último día de su periodo) en formato YYYY-MM-DD. Se incluyen los modelos con fecha mayor o igual.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"description": "Fecha máxima del modelo (el último día de su periodo) en formato YYYY-MM-DD. Se incluyen los modelos con fecha menor o igual.",
						"schema": {
							"type": "string",
							"format": "date"
						}
					},
					{
						"name": "status",
						"in": "query",
						"description": "Estado del modelo. Hoy todos los modelos guardados están en `generated`, así que el filtro no restringe nada; existe para que un cliente pueda fijarlo desde el principio.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"generated"
								]
							}
						}
					},
					{
						"name": "allTheseTags",
						"in": "query",
						"description": "Listado de todas las etiquetas que debe contener el modelo de impuestos para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "anyOfTheseTags",
						"in": "query",
						"description": "Listado de cualquiera de las etiquetas que debe contener el modelo de impuestos para ser incluido en los resultados.\n\nRepite el parámetro tantas veces como etiquetas quieras incluir.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "hasTags",
						"in": "query",
						"description": "Indicar este parámetro con valor 'true' para recibir solo modelos de impuestos que tengan al menos una etiqueta",
						"schema": {
							"type": "boolean"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden de los resultados.\n\nPuedes indicar varios parámetros para ordenar por más de un criterio e indicar el carácter - delante para que el orden sea descendente. Por ejemplo, 'sortBy=-fiscalYear&sortBy=date'.\n\nOpciones: date (último día del periodo), total (resultado), fiscalYear, creationDate y modificationDate. Sin indicarlo, los modelos salen por fecha descendente.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"date",
									"-date",
									"total",
									"-total",
									"fiscalYear",
									"-fiscalYear",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "related",
						"in": "query",
						"description": "Información adicional por modelo: `boxes` añade las casillas a cada elemento y `journal` su asiento contable en `related.journal`.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"boxes",
									"journal"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de modelos de impuestos",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/GetTaxDeclarationsResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"taxDeclarations:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/taxDeclarations/{id}": {
			"get": {
				"tags": [
					"Declaraciones de impuestos"
				],
				"summary": "Obtener un modelo de impuestos",
				"description": "Devuelve un modelo de impuestos con sus casillas, tal como se escriben en el fichero de presentación de la AEAT. En las declaraciones informativas, `related=records` añade los registros por tercero (declarados, operadores o perceptores). Los modelos eliminados responden 404.",
				"operationId": "getTaxDeclaration",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del modelo de impuestos (declaración). Formado por el prefijo \"tax_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "related",
						"in": "query",
						"description": "Información adicional: `records` añade los registros por tercero de las declaraciones informativas y `journal` el asiento contable del modelo en `related.journal`.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"records",
									"journal"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Modelo de impuestos solicitado",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/TaxDeclarationResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"taxDeclarations:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/taxDeclarations/{id}/pdf": {
			"put": {
				"tags": [
					"Declaraciones de impuestos"
				],
				"summary": "Generar el PDF de un modelo de impuestos",
				"description": "Devuelve el PDF resumen del modelo (casillas y valores), el mismo que imprime la web, con una URL temporal desde la que descargarlo. El PDF se genera solo si aún no existe o si el modelo ha cambiado desde la última generación; si no, se reutiliza el ya generado. No calcula ni modifica el modelo.\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que como mucho genera un fichero, así que se puede repetir sin riesgo.",
				"operationId": "createTaxDeclarationPDF",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del modelo de impuestos (declaración). Formado por el prefijo \"tax_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"$ref": "#/components/requestBodies/CreateDocumentPDFRequest"
				},
				"responses": {
					"200": {
						"$ref": "#/components/responses/GetDocumentPDFResponse"
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"taxDeclarations:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/taxDeclarations/{id}/aeatFile": {
			"put": {
				"tags": [
					"Declaraciones de impuestos"
				],
				"summary": "Generar el fichero de presentación de un modelo de impuestos",
				"description": "Devuelve el fichero de presentación de la AEAT (diseño de registro BOE) de un modelo ya guardado, el mismo que descarga el botón «Descargar fichero AEAT» de la web, con la URL desde la que descargarlo. El fichero se compone solo si aún no existe o si el modelo ha cambiado desde la última generación; si no, se devuelve el ya generado (normalmente el que la web generó al crear el modelo). Se construye a partir de las casillas guardadas: no calcula ni modifica el modelo, y la presentación sigue haciéndose desde la Sede de la AEAT. El 390 no tiene fichero (se rellena en la Sede) y responde 404.\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que como mucho compone un fichero a partir del modelo guardado, así que se puede repetir sin riesgo.",
				"operationId": "createTaxDeclarationAeatFile",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del modelo de impuestos (declaración). Formado por el prefijo \"tax_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Fichero de presentación del modelo",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/CreateTaxDeclarationAeatFileResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"taxDeclarations:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/taxDeclarations/{id}/attachments": {
			"get": {
				"tags": [
					"Declaraciones de impuestos"
				],
				"summary": "Listar adjuntos de un modelo de impuestos",
				"operationId": "getTaxDeclarationAttachments",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"description": "ID  del modelo de impuestos (declaración). Formado por el prefijo \"tax_\" y un uuid v4",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de adjuntos de un modelo de impuestos",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "getTaxDeclarationAttachmentsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Attachment"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"taxDeclarations:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/settings/taxes/sales": {
			"get": {
				"tags": [
					"Ajustes"
				],
				"summary": "Lista de impuestos de venta disponibles",
				"description": "Devuelve una lista de los impuestos de venta disponibles en la empresa",
				"operationId": "getSalesTaxes",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "taxGroup",
						"in": "query",
						"description": "Grupo de impuestos.\n\n  No se debe asumir que siempre van a existir estos valores, si hay cambios normativos pueden definirse nuevos valores en cualquier momento.\n\n  Los grupos disponibles en cada empresas pueden ser distintos según su dirección fiscal.\n  \n  * IVA: IVA\n  * IVA_RE: IVA de recargo de equivalencia\n  * IGIC: Impuesto General Indirecto Canario (Canarias)\n  * IPSI: Impuesto sobre la Producción, los Servicios y la Importación (Ceuta y Melilla)\n  * IRPF: Retención de IRPF\n  * VATEU: IVA de países de la EU distintos de España (IVA declarado en dichos países)\n  ",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"IVA",
									"IVA_RE",
									"IGIC",
									"IPSI",
									"IRPF",
									"VATEU"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de impuestos de venta",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetSalesTaxesResponse",
									"required": [
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/SalesTax"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"settings:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/settings/taxes/purchases": {
			"get": {
				"tags": [
					"Ajustes"
				],
				"summary": "Lista de impuestos de compra disponibles",
				"description": "Devuelve una lista de los impuestos de compra disponibles en la empresa",
				"operationId": "getPurchasesTaxes",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "taxGroup",
						"in": "query",
						"description": "Grupo de impuestos.\n\n  No se debe asumir que siempre van a existir estos valores, si hay cambios normativos pueden definirse nuevos valores en cualquier momento.\n\n  Los grupos disponibles en cada empresas pueden ser distintos según su dirección fiscal.\n  \n  * IVA: IVA\n  * IVA_RE: IVA de recargo de equivalencia\n  * IGIC: Impuesto General Indirecto Canario (Canarias)\n  * IPSI: Impuesto sobre la Producción, los Servicios y la Importación (Ceuta y Melilla)\n  * IRPF: Retención de IRPF\n  ",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"IVA",
									"IVA_RE",
									"IGIC",
									"IPSI",
									"IRPF"
								]
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de impuestos de compra",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPurchasesTaxesResponse",
									"required": [
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"$ref": "#/components/schemas/PurchasesTax"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"settings:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/settings/themes": {
			"get": {
				"tags": [
					"Ajustes"
				],
				"summary": "Lista de plantillas de documentos disponibles",
				"description": "Devuelve una lista de las plantillas disponibles en la empresa para documentos de venta",
				"operationId": "getThemes",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					}
				],
				"responses": {
					"200": {
						"description": "Lista de plantillas de documentos",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetThemesResponse",
									"required": [
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"type": "object",
												"additionalProperties": false,
												"required": [
													"id",
													"title"
												],
												"properties": {
													"id": {
														"type": "string"
													},
													"title": {
														"type": "string"
													}
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"settings:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/settings/series/{documentType}": {
			"get": {
				"tags": [
					"Ajustes"
				],
				"summary": "Lista de series de numeración",
				"description": "Devuelve una lista de las series de numeración definidas en la empresa para el tipo de documento indicado",
				"operationId": "getSeries",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "documentType",
						"in": "path",
						"required": true,
						"description": "Tipo de documento\n\nValores disponibles:\n* invoice: Facturas de venta\n* estimate: Presupuestos\n* deliveryNote: Albaranes\n* clientOrder: Pedidos de cliente\n* purchaseOrder: Órdenes de compra",
						"schema": {
							"type": "string",
							"enum": [
								"invoice",
								"estimate",
								"deliveryNote",
								"clientOrder",
								"purchaseOrder"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Lista de series de numeración",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetSeriesResponse",
									"required": [
										"items"
									],
									"additionalProperties": false,
									"properties": {
										"items": {
											"type": "array",
											"title": "Items",
											"items": {
												"type": "object",
												"additionalProperties": false,
												"required": [
													"serie",
													"reset",
													"notes",
													"manual",
													"theme"
												],
												"properties": {
													"serie": {
														"type": "string",
														"description": "Valor de la serie\n\nPuede contener los textos \"##\" o \"####\" que se sustituyen por el año de la fecha del documento en el momento de guardarse"
													},
													"reset": {
														"type": "string",
														"enum": [
															"never",
															"year"
														],
														"description": "Indica si la serie reinicia la numeración con el cambio de año (year) o el primer documento de un año continúa con la numeración del último del año anterior (never)"
													},
													"notes": {
														"type": "string",
														"description": "Notas descriptivas de la serie"
													},
													"manual": {
														"type": "boolean",
														"description": "Indica si esta serie acepta numeración manual en la interfaz de FacturaDirecta"
													},
													"invoiceType": {
														"type": "string",
														"enum": [
															"complete",
															"complete_correction",
															"simplified",
															"simplified_correction",
															"external"
														],
														"description": "Indica el tipo de facturas a las que puede aplicarse esta serie (solo para series de facturas):\n\n* complete: Facturas completas\n* complete_correction: Facturas completas rectificativas\n* simplified: Facturas simplificadas\n* simplified_correction: Facturas simplificadas rectificativas\n* external: Facturas externas (emitidas por terceros)\n"
													},
													"correction": {
														"type": "boolean",
														"description": "Indica si esta serie pertenece a documentos rectificativos (De aplicación solo para series de facturas)\nOBSOLETO: Usar invoiceType"
													},
													"theme": {
														"type": "string",
														"description": "Identificador de la plantilla aplicada a los documentos de esta serie si no se indica una en el momento de su creación"
													}
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"settings:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/settings/company": {
			"get": {
				"tags": [
					"Ajustes"
				],
				"summary": "Ficha y forma de trabajar de la empresa",
				"description": "Devuelve los datos de la empresa y su configuración operativa: dirección fiscal, moneda, idioma y zona horaria, modo borrador o definitivo, régimen fiscal, VeriFactu y TicketBAI, fecha de bloqueo contable, canales de entrada de la bandeja (buzón por correo y Google Drive) y módulos disponibles. Es la llamada recomendada tras `GET /profile` para conocer la empresa antes de operar; cambia con muy poca frecuencia, así que puede cachearse. Solo lectura.",
				"operationId": "getCompanySettings",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					}
				],
				"responses": {
					"200": {
						"description": "Ficha de la empresa",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetCompanySettingsResponse",
									"required": [
										"content"
									],
									"additionalProperties": false,
									"properties": {
										"content": {
											"$ref": "#/components/schemas/CompanySettings"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"settings:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/webhooks/endpoints": {
			"get": {
				"tags": [
					"Webhooks"
				],
				"summary": "Lista de endpoints de webhooks",
				"description": "Devuelve la lista de endpoints de webhooks configurados en la empresa",
				"operationId": "listPublicWebhookEndpoints",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					}
				],
				"responses": {
					"200": {
						"description": "Lista de endpoints",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "ListPublicWebhookEndpointsResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/WebhookEndpoint"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Webhooks"
				],
				"summary": "Crear endpoint de webhook",
				"description": "Crea un nuevo endpoint de webhook. El `signing_secret` retornado solo se muestra una vez.",
				"operationId": "createPublicWebhookEndpoint",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"name",
									"url",
									"events"
								],
								"properties": {
									"name": {
										"type": "string",
										"description": "Nombre descriptivo del endpoint"
									},
									"url": {
										"type": "string",
										"description": "URL HTTPS de destino"
									},
									"events": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"description": "Tipos de eventos a los que se suscribe el endpoint. Cada tipo tiene el formato `<recurso>.<accion>`. Categorías y tipos disponibles:\n\n* Facturas: `invoice.created`, `invoice.updated`, `invoice.archived`, `invoice.unarchived`, `invoice.sent`, `invoice.voided`, `invoice.verifactu_sent`.\n* Gastos: `expense.created`, `expense.updated`, `expense.archived`, `expense.unarchived`.\n* Contactos: `contact.created`, `contact.updated`, `contact.archived`, `contact.unarchived`.\n* Presupuestos: `estimate.created`, `estimate.updated`, `estimate.archived`, `estimate.unarchived`.\n* Albaranes: `delivery_note.created`, `delivery_note.updated`, `delivery_note.archived`, `delivery_note.unarchived`.\n* Pedidos: `client_order.created`, `client_order.updated`, `client_order.archived`, `client_order.unarchived`.\n* Órdenes de compra: `purchase_order.created`, `purchase_order.updated`, `purchase_order.archived`, `purchase_order.unarchived`.\n* Transacciones: `transaction.created`, `transaction.updated`, `transaction.archived`, `transaction.unarchived`.\n* Productos: `product.created`, `product.updated`, `product.archived`, `product.unarchived`.\n* VeriFactu: `verifactu_batch.sent`.\n* Bandeja de entrada: `inbox.scanned`.\n\nEl catálogo puede ampliarse ante cambios; no asumir un closed set. Si necesitas el catálogo programáticamente, se publica en el cuerpo de la operación. Para suscribirse a todos los eventos de una categoría, declarar cada tipo explícitamente."
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Endpoint creado con el secret de firma",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreatePublicWebhookEndpointResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"signing_secret"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/WebhookEndpoint"
										},
										"signing_secret": {
											"type": "string",
											"description": "Secret de firma (formato whsec_...). Solo se muestra en la creación."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/webhooks/endpoints/{endpointId}": {
			"get": {
				"tags": [
					"Webhooks"
				],
				"summary": "Obtener endpoint de webhook",
				"operationId": "getPublicWebhookEndpoint",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "endpointId",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Detalles del endpoint",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPublicWebhookEndpointResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/WebhookEndpoint"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Webhooks"
				],
				"summary": "Actualizar endpoint de webhook",
				"operationId": "updatePublicWebhookEndpoint",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "endpointId",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"additionalProperties": false,
								"description": "Actualización parcial: solo se modifican los campos enviados. Los omitidos conservan su valor actual.",
								"properties": {
									"name": {
										"type": "string",
										"description": "Nuevo nombre descriptivo."
									},
									"url": {
										"type": "string",
										"description": "Nueva URL HTTPS de destino."
									},
									"events": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"description": "Nueva lista de tipos de eventos suscritos (reemplaza la anterior). Ver el catálogo en `POST /webhooks/endpoints`."
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Endpoint actualizado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdatePublicWebhookEndpointResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/WebhookEndpoint"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Webhooks"
				],
				"summary": "Eliminar endpoint de webhook",
				"operationId": "deletePublicWebhookEndpoint",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "endpointId",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Endpoint eliminado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "DeletePublicWebhookEndpointResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/webhooks/endpoints/{endpointId}/enable": {
			"post": {
				"tags": [
					"Webhooks"
				],
				"summary": "Activar endpoint de webhook",
				"operationId": "enablePublicWebhookEndpoint",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "endpointId",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Endpoint activado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "EnablePublicWebhookEndpointResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"type": "object",
											"additionalProperties": false,
											"required": [
												"enabled",
												"requeued"
											],
											"properties": {
												"enabled": {
													"type": "boolean"
												},
												"requeued": {
													"type": "number",
													"description": "Número de eventos fallidos reencolados"
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/webhooks/endpoints/{endpointId}/disable": {
			"post": {
				"tags": [
					"Webhooks"
				],
				"summary": "Desactivar endpoint de webhook",
				"operationId": "disablePublicWebhookEndpoint",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "endpointId",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Endpoint desactivado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "DisablePublicWebhookEndpointResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"type": "object",
											"additionalProperties": false,
											"required": [
												"enabled"
											],
											"properties": {
												"enabled": {
													"type": "boolean"
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/webhooks/endpoints/{endpointId}/rotateSecret": {
			"post": {
				"tags": [
					"Webhooks"
				],
				"summary": "Rotar secret de firma del endpoint",
				"description": "Genera un nuevo secret de firma para el endpoint. El secret anterior queda invalidado.\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): la respuesta lleva un secreto que no se conserva, y basta con volver a llamarla: el secret válido es el de la última llamada.",
				"operationId": "rotatePublicWebhookEndpointSecret",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "endpointId",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Nuevo secret de firma",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "RotatePublicWebhookEndpointSecretResponse",
									"additionalProperties": false,
									"required": [
										"signing_secret"
									],
									"properties": {
										"signing_secret": {
											"type": "string",
											"description": "Nuevo secret de firma (formato whsec_...)"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/webhooks/events": {
			"get": {
				"tags": [
					"Webhooks"
				],
				"summary": "Lista de eventos de webhook",
				"description": "Devuelve el historial de eventos enviados a los endpoints de webhook, de más reciente a más antiguo. Usa paginación por cursor.",
				"operationId": "listPublicWebhookEvents",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "endpointId",
						"in": "query",
						"schema": {
							"type": "string"
						},
						"description": "Filtrar por endpoint"
					},
					{
						"name": "type",
						"in": "query",
						"schema": {
							"type": "string"
						},
						"description": "Filtrar por tipo de evento"
					},
					{
						"name": "status",
						"in": "query",
						"schema": {
							"type": "string"
						},
						"description": "Filtrar por estado (pending, delivered, failed)"
					},
					{
						"name": "limit",
						"in": "query",
						"schema": {
							"type": "string"
						},
						"description": "Número máximo de resultados (máx. 100)"
					},
					{
						"name": "cursor",
						"in": "query",
						"schema": {
							"type": "string"
						},
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella. Para la primera página, se omite."
					}
				],
				"responses": {
					"200": {
						"description": "Lista de eventos",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "ListPublicWebhookEventsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/WebhookEvent"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más eventos detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más eventos."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/webhooks/events/{eventId}": {
			"get": {
				"tags": [
					"Webhooks"
				],
				"summary": "Obtener evento de webhook",
				"operationId": "getPublicWebhookEvent",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "eventId",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Detalles del evento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPublicWebhookEventResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/WebhookEvent"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/webhooks/events/{eventId}/retry": {
			"post": {
				"tags": [
					"Webhooks"
				],
				"summary": "Reintentar entrega de evento",
				"description": "Reencola el evento para reintento de entrega al endpoint correspondiente",
				"operationId": "retryPublicWebhookEvent",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "eventId",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Evento reencolado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "RetryPublicWebhookEventResponse",
									"additionalProperties": false,
									"required": [
										"queued"
									],
									"properties": {
										"queued": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"webhooks:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/customFields": {
			"get": {
				"tags": [
					"Campos personalizados"
				],
				"summary": "Lista de campos personalizados",
				"description": "Devuelve el catálogo de campos personalizados. Por defecto solo incluye los activos.",
				"operationId": "getCustomFields",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "title",
						"in": "query",
						"description": "Búsqueda aproximada por nombre.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "docTypes",
						"in": "query",
						"description": "Tipos de documento. Se incluyen campos aplicables a cualquiera de los valores indicados.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"invoice",
									"estimate",
									"deliveryNote",
									"clientOrder",
									"purchaseOrder",
									"bill",
									"payroll",
									"contact"
								]
							}
						}
					},
					{
						"name": "archived",
						"in": "query",
						"description": "Filtra campos activos (false), borrados (true) o ambos (all).",
						"schema": {
							"type": "string",
							"enum": [
								"false",
								"true",
								"all"
							],
							"default": "false"
						}
					},
					{
						"$ref": "#/components/parameters/MinCreationDate"
					},
					{
						"$ref": "#/components/parameters/MaxCreationDate"
					},
					{
						"$ref": "#/components/parameters/MinModificationDate"
					},
					{
						"$ref": "#/components/parameters/MaxModificationDate"
					},
					{
						"name": "sortBy",
						"in": "query",
						"description": "Orden. Repite el parámetro y usa - para orden descendente.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"title",
									"-title",
									"creationDate",
									"-creationDate",
									"modificationDate",
									"-modificationDate"
								]
							}
						}
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					}
				],
				"responses": {
					"200": {
						"description": "Lista de campos personalizados",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetCustomFieldsResponse",
									"additionalProperties": false,
									"required": [
										"pagination",
										"items"
									],
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/CustomField"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"customFields:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Campos personalizados"
				],
				"summary": "Crear campo personalizado",
				"description": "Crea un campo. Si se indica id debe ser cfi_ + UUID v4 en minúsculas y no puede estar ocupado, ni siquiera por un campo borrado. El límite del plan puede devolver 403.",
				"operationId": "createCustomField",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "CreateCustomFieldRequest",
								"additionalProperties": false,
								"required": [
									"title",
									"docTypes"
								],
								"properties": {
									"id": {
										"type": "string",
										"pattern": "^cfi_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
									},
									"title": {
										"type": "string",
										"minLength": 1,
										"maxLength": 100,
										"description": "Nombre visible del campo."
									},
									"docTypes": {
										"type": "array",
										"minItems": 1,
										"items": {
											"type": "string",
											"enum": [
												"invoice",
												"estimate",
												"deliveryNote",
												"clientOrder",
												"purchaseOrder",
												"bill",
												"payroll",
												"contact"
											]
										},
										"description": "Tipos de documento en los que se muestra el campo."
									}
								}
							},
							"examples": {
								"invoiceReference": {
									"summary": "Campo de referencia para facturas y presupuestos",
									"value": {
										"title": "Referencia de pedido",
										"docTypes": [
											"invoice",
											"estimate"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "CreateCustomFieldResponse",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateCustomFieldResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/CustomField"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"customFields:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/customFields/{id}": {
			"get": {
				"tags": [
					"Campos personalizados"
				],
				"summary": "Obtener campo personalizado",
				"description": "Devuelve un campo por ID, también si está borrado.",
				"operationId": "getCustomField",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "ID del campo personalizado (cfi_ seguido de UUID v4 en minúsculas).",
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "GetCustomFieldResponse",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetCustomFieldResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/CustomField"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"customFields:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"put": {
				"tags": [
					"Campos personalizados"
				],
				"summary": "Actualizar campo personalizado",
				"description": "Reemplaza title y docTypes. Los valores de tipos retirados se conservan en los documentos, pero dejan de mostrarse. Un campo borrado debe recuperarse antes.",
				"operationId": "updateCustomField",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "ID del campo personalizado (cfi_ seguido de UUID v4 en minúsculas).",
						"schema": {
							"type": "string"
						}
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "UpdateCustomFieldRequest",
								"additionalProperties": false,
								"required": [
									"title",
									"docTypes"
								],
								"properties": {
									"title": {
										"type": "string",
										"minLength": 1,
										"maxLength": 100,
										"description": "Nombre visible del campo."
									},
									"docTypes": {
										"type": "array",
										"minItems": 1,
										"items": {
											"type": "string",
											"enum": [
												"invoice",
												"estimate",
												"deliveryNote",
												"clientOrder",
												"purchaseOrder",
												"bill",
												"payroll",
												"contact"
											]
										},
										"description": "Tipos de documento en los que se muestra el campo."
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "UpdateCustomFieldResponse",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UpdateCustomFieldResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/CustomField"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"customFields:write"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Campos personalizados"
				],
				"summary": "Borrar campo personalizado",
				"description": "Borra de forma no destructiva. Los valores guardados en documentos se conservan.",
				"operationId": "deleteCustomField",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "ID del campo personalizado (cfi_ seguido de UUID v4 en minúsculas).",
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "Campo borrado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "DeleteCustomFieldResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"customFields:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/customFields/{id}/restore": {
			"post": {
				"tags": [
					"Campos personalizados"
				],
				"summary": "Recuperar campo personalizado",
				"description": "Recupera un campo borrado. Es idempotente. Puede devolver 403 por la feature de recuperación o por el límite de campos del plan.",
				"operationId": "restoreCustomField",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "ID del campo personalizado (cfi_ seguido de UUID v4 en minúsculas).",
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "RestoreCustomFieldResponse",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "RestoreCustomFieldResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/CustomField"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"customFields:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/apiKeyInfo": {
			"get": {
				"tags": [
					"API Keys"
				],
				"summary": "Información de la API key actual",
				"description": "Devuelve los scopes asociados a la API key utilizada para realizar la petición. Este endpoint solo está disponible con autenticación mediante API key.",
				"operationId": "getPublicApiKeyInfo",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					}
				],
				"responses": {
					"200": {
						"description": "Información de la API key actual",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPublicApiKeyInfoResponse",
									"additionalProperties": false,
									"required": [
										"scopes"
									],
									"properties": {
										"scopes": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Lista de scopes autorizados para la API key"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/apiKeys": {
			"get": {
				"tags": [
					"API Keys"
				],
				"summary": "Lista de API keys",
				"description": "Devuelve la lista de API keys configuradas en la empresa (sin datos sensibles)",
				"operationId": "listPublicApiKeys",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					}
				],
				"responses": {
					"200": {
						"description": "Lista de API keys",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "ListPublicApiKeysResponse",
									"additionalProperties": false,
									"required": [
										"items"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/PublicApiKeyInfo"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"apiKeys:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"API Keys"
				],
				"summary": "Crear API key",
				"description": "Crea una nueva API key. El campo `apiKey` de la respuesta contiene la clave completa y solo se muestra una vez. Las API keys creadas vía API tienen el flag `managedViaApi: true` y pueden ser eliminadas vía API.",
				"operationId": "createPublicApiKey",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"name",
									"scopes"
								],
								"properties": {
									"name": {
										"type": "string",
										"description": "Nombre descriptivo de la API key"
									},
									"scopes": {
										"type": "array",
										"items": {
											"type": "string"
										},
										"minItems": 1,
										"description": "Scopes a asignar a la nueva API key. Tienen que ser scopes que quien la crea pueda usar en la empresa: si el caller es una API key, un subconjunto de los suyos; con OAuth, scopes de su token que permitan su rol y, si la hay, la aplicación conectada (en contactos, sobre clientes, proveedores y empleados)."
									}
								}
							},
							"examples": {
								"basic": {
									"summary": "API key con lectura de contactos",
									"value": {
										"name": "Mi API key",
										"scopes": [
											"contacts:read"
										]
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "API key creada",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreatePublicApiKeyResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"apiKey"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/PublicApiKeyInfo"
										},
										"apiKey": {
											"type": "string",
											"description": "Clave API completa (solo visible en la creación)"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"apiKeys:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/apiKeys/{id}": {
			"get": {
				"tags": [
					"API Keys"
				],
				"summary": "Obtener API key",
				"description": "Devuelve los datos de una API key por su identificador",
				"operationId": "getPublicApiKey",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						},
						"description": "Identificador de la API key"
					}
				],
				"responses": {
					"200": {
						"description": "Datos de la API key",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPublicApiKeyResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/PublicApiKeyInfo"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"apiKeys:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"API Keys"
				],
				"summary": "Eliminar API key",
				"description": "Elimina una API key creada vía API (`managedViaApi: true`). Las API keys creadas manualmente no pueden eliminarse vía API. Una API key no puede eliminarse a sí misma.",
				"operationId": "deletePublicApiKey",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						},
						"description": "Identificador de la API key a eliminar"
					}
				],
				"responses": {
					"200": {
						"description": "API key eliminada",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "DeletePublicApiKeyResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"apiKeys:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/uploads": {
			"post": {
				"tags": [
					"Uploads"
				],
				"summary": "Subir un archivo",
				"description": "Sube un archivo a FacturaDirecta para poder vincularlo después a un documento (factura, factura de compra, presupuesto, albarán, nómina o factura recurrente).\n\nEl upload es un recurso temporal con TTL de 24 horas. Si no se vincula a un documento dentro de ese plazo, caduca y se purga automáticamente.\n\n**Modo multipart/form-data** (recomendado para clientes y agentes):\n- Envía el binario en el campo `file` de un `multipart/form-data`.\n- Tamaño máximo: **10 MB**.\n- Devuelve directamente un upload en estado `committed`, listo para vincular.\n- Si el archivo excede el límite, se devuelve un error 413 con `code: \"upload_too_large_for_multipart\"` y un `hint` apuntando al modo presigned.\n\n**Modo presigned (application/json)**:\n- Body: `{ filename, contentType }`.\n- Devuelve un `signedRequest` (URL pre-firmada de S3) para que el cliente haga `PUT` con el binario directo a S3 (sin pasar por el API).\n- Después debe llamarse a `POST /api/{companyId}/uploads/{uploadId}/commit` para sellar el upload.\n- Tamaño máximo: **25 MB** (verificado en el commit).\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): la respuesta puede llevar una URL firmada de vida corta que no tendría sentido repetir, y un upload duplicado es inocuo: caduca y se purga solo.",
				"operationId": "createUpload",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"multipart/form-data": {
							"schema": {
								"type": "object",
								"required": [
									"file"
								],
								"properties": {
									"file": {
										"type": "string",
										"format": "binary",
										"description": "Contenido binario del archivo"
									}
								}
							}
						},
						"application/json": {
							"schema": {
								"type": "object",
								"required": [
									"filename"
								],
								"additionalProperties": false,
								"properties": {
									"filename": {
										"type": "string",
										"description": "Nombre del archivo (incluyendo extensión)"
									},
									"contentType": {
										"type": "string",
										"description": "MIME type del archivo. Si no se indica, se usa application/octet-stream."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Solicitar URL presigned",
									"value": {
										"filename": "factura.pdf",
										"contentType": "application/pdf"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Upload creado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateUploadResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"oneOf": [
												{
													"$ref": "#/components/schemas/PublicApiUpload"
												},
												{
													"$ref": "#/components/schemas/PublicApiPresignedUpload"
												}
											]
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"413": {
						"description": "El archivo excede el límite de subida proxyeada",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "UploadTooLargeResponse",
									"properties": {
										"errors": {
											"type": "array",
											"items": {
												"type": "object",
												"properties": {
													"code": {
														"type": "string",
														"enum": [
															"upload_too_large_for_multipart"
														]
													},
													"message": {
														"type": "string"
													},
													"hint": {
														"type": "object",
														"properties": {
															"alternativeMode": {
																"type": "string"
															},
															"alternativeEndpoint": {
																"type": "string"
															},
															"alternativeContentType": {
																"type": "string"
															},
															"maxProxySize": {
																"type": "integer"
															},
															"maxPresignedSize": {
																"type": "integer"
															}
														}
													}
												}
											}
										}
									}
								}
							}
						}
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"files:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/uploads/{uploadId}/commit": {
			"post": {
				"tags": [
					"Uploads"
				],
				"summary": "Sellar un upload presigned tras subirlo a S3",
				"description": "Cierra un upload creado con el modo presigned: verifica que el binario está en S3, comprueba el tamaño contra el límite (25 MB), detecta automáticamente si es un Facturae y deja el upload en estado `committed`, listo para vincular a un documento.\n\nSi el archivo supera el límite se devuelve un 413 con `code: \"upload_too_large_for_presigned\"` y el upload pasa a `expired`.\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): ya es idempotente por diseño: sellar dos veces el mismo upload da el mismo resultado.",
				"operationId": "commitUpload",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "uploadId",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						},
						"description": "Identificador del upload (prefijo `upl_`) devuelto por POST /uploads en modo presigned."
					}
				],
				"responses": {
					"200": {
						"description": "Upload sellado correctamente",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CommitUploadResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/PublicApiUpload"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"413": {
						"description": "El archivo supera el límite del modo presigned",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CommitUploadTooLargeResponse"
								}
							}
						}
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"files:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/inbox": {
			"get": {
				"tags": [
					"Bandeja de entrada"
				],
				"summary": "Lista de items en la bandeja de entrada",
				"description": "Devuelve los documentos en la bandeja, pendientes de procesar o ya procesados por el escáner. Incluye items de cualquier origen: `upload` (API pública), `inbox` (email vía Mailgun), `googleDrive` (sincronización con Drive) y `scanner` (subida manual desde la pantalla de Tareas). Filtra por `source` para acotar a un origen concreto. Por defecto solo se devuelven los no archivados.",
				"operationId": "getInboxItems",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Limit"
					},
					{
						"$ref": "#/components/parameters/Offset"
					},
					{
						"name": "status",
						"in": "query",
						"required": false,
						"description": "Filtrar por estado del escaneo",
						"schema": {
							"type": "string",
							"enum": [
								"pending",
								"scanned",
								"scan_failed"
							]
						}
					},
					{
						"name": "source",
						"in": "query",
						"required": false,
						"description": "Filtrar por origen del item. Si se omite, se devuelven items de cualquier origen.",
						"schema": {
							"type": "string",
							"enum": [
								"upload",
								"inbox",
								"googleDrive",
								"scanner"
							]
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"required": false,
						"description": "Fecha y hora mínima de creación del item (`createdAt`), incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta desde el inicio de ese día en la zona horaria de la empresa.",
						"allowReserved": true,
						"schema": {
							"type": "string",
							"anyOf": [
								{
									"type": "string",
									"format": "date"
								},
								{
									"type": "string",
									"format": "date-time"
								}
							]
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"required": false,
						"description": "Fecha y hora máxima de creación del item (`createdAt`), incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta hasta el final de ese día en la zona horaria de la empresa.",
						"allowReserved": true,
						"schema": {
							"type": "string",
							"anyOf": [
								{
									"type": "string",
									"format": "date"
								},
								{
									"type": "string",
									"format": "date-time"
								}
							]
						}
					},
					{
						"name": "archived",
						"in": "query",
						"required": false,
						"description": "Filtrar por estado de archivado: `false` (defecto, solo activos), `true` (solo archivados), `all` (ambos)",
						"schema": {
							"type": "string",
							"enum": [
								"false",
								"true",
								"all"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Listado paginado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetInboxItemsResponse",
									"additionalProperties": false,
									"required": [
										"pagination",
										"items"
									],
									"properties": {
										"pagination": {
											"$ref": "#/components/schemas/Pagination"
										},
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/InboxItem"
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"inbox:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"post": {
				"tags": [
					"Bandeja de entrada"
				],
				"summary": "Subir un documento a la bandeja de entrada",
				"description": "Crea un item en la bandeja de entrada que será procesado por el escáner LLM. Dos modos:\n\n**Modo JSON** — `Content-Type: application/json`. Cuerpo: `{ upload: \"upl_…\", title?: string, idempotencyKey?: string }`. Se asume que ya has subido el binario con `POST /uploads`. El upload se \"consume\" (no se podrá vincular a otro documento).\n\n**Modo multipart** — `Content-Type: multipart/form-data`. Campos: `file` (binario, obligatorio), `title` (opcional), `idempotencyKey` (opcional). One-shot: equivalente a `POST /uploads` (multipart) seguido de `POST /inbox` (JSON) en una sola llamada.\n\n**Idempotencia.** Si pasas `idempotencyKey` y ya existe un item activo (no archivado) en esta empresa con esa misma key, se devuelve el existente y no se crea uno nuevo (200 OK, no 409). Internamente se mapea a `task.main.sourceKey`.\n\n**Estado inicial.** El item se crea con `status: \"pending\"` y `scan: null`. El escaneo corre en segundo plano. El cliente puede hacer polling sobre `GET /inbox/{id}` hasta ver `status: \"scanned\"` o `\"scan_failed\"`.\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): tiene su propio mecanismo, de otra naturaleza: el campo `idempotencyKey` del cuerpo evita crear dos veces el mismo item sin caducidad, mientras el primero siga activo, también cuando el documento se reenvía días después.",
				"operationId": "createInboxItem",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"upload"
								],
								"properties": {
									"upload": {
										"type": "string",
										"description": "Identificador (`upl_…`) devuelto por POST /uploads"
									},
									"title": {
										"type": "string",
										"description": "Título opcional. Si no se indica, se usa el nombre del archivo."
									},
									"idempotencyKey": {
										"type": "string",
										"description": "Clave de idempotencia opcional. Reintentos con la misma clave devuelven el mismo item."
									}
								}
							},
							"examples": {
								"default": {
									"summary": "Crear inbox item desde un upload previo",
									"value": {
										"upload": "upl_00000000-0000-4000-8000-000000000000",
										"title": "factura.pdf"
									}
								}
							}
						},
						"multipart/form-data": {
							"schema": {
								"type": "object",
								"required": [
									"file"
								],
								"properties": {
									"file": {
										"type": "string",
										"format": "binary",
										"description": "Contenido binario del archivo"
									},
									"title": {
										"type": "string",
										"description": "Título opcional"
									},
									"idempotencyKey": {
										"type": "string",
										"description": "Clave de idempotencia opcional"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Item creado (o ya existente si se ha activado idempotencia)",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "CreateInboxItemResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/InboxItem"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"413": {
						"description": "El archivo supera el límite de la bandeja",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "InboxUploadTooLargeResponse"
								}
							}
						}
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"inbox:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/inbox/{id}": {
			"get": {
				"tags": [
					"Bandeja de entrada"
				],
				"summary": "Detalle de un item de la bandeja",
				"description": "Devuelve el item completo, incluyendo el campo `scan.text` con el OCR crudo (omitido en el listado por tamaño).",
				"operationId": "getInboxItem",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						},
						"description": "Identificador del item (prefijo `tas_`)"
					}
				],
				"responses": {
					"200": {
						"description": "Item solicitado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetInboxItemResponse",
									"additionalProperties": false,
									"required": [
										"content"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/InboxItem"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"inbox:read"
						]
					},
					{
						"apiKey": []
					}
				]
			},
			"delete": {
				"tags": [
					"Bandeja de entrada"
				],
				"summary": "Archivar un item de la bandeja",
				"description": "Archiva el item (no lo borra físicamente). Sigue siendo consultable con `?archived=true` en el listado. Mismo comportamiento que `DELETE` en facturas y otros documentos.",
				"operationId": "deleteInboxItem",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"$ref": "#/components/parameters/Idempotency-Key"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						},
						"description": "Identificador del item (prefijo `tas_`)"
					}
				],
				"responses": {
					"200": {
						"description": "Item archivado",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "DeleteInboxItemResponse",
									"additionalProperties": false,
									"required": [
										"result"
									],
									"properties": {
										"result": {
											"type": "boolean"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"$ref": "#/components/responses/IdempotencyKeyReusedError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"inbox:write"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/inbox/{id}/proposePayroll": {
			"post": {
				"tags": [
					"Bandeja de entrada"
				],
				"summary": "Propuesta de nómina desde un item de la bandeja",
				"description": "Construye un prototipo de nómina a partir de la extracción rica del task. El endpoint NO crea nada en BD: devuelve el `content` ya mapeado al shape FD (líneas, totales, contacto resuelto, modelo190) para que el agente lo revise, lo ajuste si quiere, y lo reenvíe a `POST /payrolls` con `fromInbox: { taskId }`. Es idempotente y retry-safe.\n\n**Requiere que la empresa tenga activa la feature `scanPayroll`** (activa por defecto; puede desactivarse por empresa). Sin esa feature el escáner no produce extracción rica de nóminas y este endpoint devuelve `422` con `code: \"feature_disabled\"`. Las facturas y tickets (`proposeBill`/`proposeTicket`) NO requieren esta feature — Abaq las extrae siempre.\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que devuelve un prototipo y no escribe nada, así que se puede repetir sin riesgo.",
				"operationId": "proposePayroll",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						},
						"description": "Identificador del item (prefijo `tas_`)"
					}
				],
				"requestBody": {
					"required": false,
					"description": "Parámetros opcionales para afinar la propuesta.",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"additionalProperties": false,
								"properties": {
									"contactId": {
										"type": "string",
										"description": "Si se indica, el server omite el matching automático y usa este contacto."
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Prototipo de nómina",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "ProposePayrollResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"matchedContact",
										"candidateContacts",
										"newContactProposal"
									],
									"properties": {
										"content": {
											"description": "Prototipo del documento listo para enviar a `POST /payrolls`. El `uuid` se omite intencionadamente — el agente debe dejarlo al server o asignar uno propio en el create.",
											"$ref": "#/components/schemas/PayrollWrite"
										},
										"matchedContact": {
											"nullable": true,
											"description": "Contacto único matched. `null` si hubo 0 o más de 1 candidato.",
											"$ref": "#/components/schemas/Contact"
										},
										"candidateContacts": {
											"type": "array",
											"description": "Lista de candidatos cuando el matching encontró varios. Vacío si hubo 0 o 1 match.",
											"items": {
												"$ref": "#/components/schemas/Contact"
											}
										},
										"newContactProposal": {
											"description": "Proto-contacto pre-rellenado con los datos extraídos. El agente puede crearlo vía `POST /contacts` y luego enlazarlo en el create.",
											"$ref": "#/components/schemas/Contact"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"description": "El task aún no se ha escaneado (`status != scanned`).",
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"description": "La extracción del task no es compatible con el tipo solicitado. Posibles `code` en el body: `feature_disabled` (solo en `proposePayroll`: la empresa no tiene activa `settings.features.scanPayroll`), `extraction_not_compatible` (el escaneo no produjo el shape esperado para el tipo solicitado), `no_extraction` (el task no tiene extracción)."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"inbox:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/inbox/{id}/proposeBill": {
			"post": {
				"tags": [
					"Bandeja de entrada"
				],
				"summary": "Propuesta de factura de compra desde un item de la bandeja",
				"description": "Construye un prototipo de factura de compra a partir de la extracción del task. El endpoint NO crea nada en BD: devuelve el `content` ya mapeado al shape FD (líneas, impuestos, IRPF, contacto resuelto, totales) para que el agente lo revise, lo ajuste si quiere, y lo reenvíe a `POST /bills` con `fromInbox: { taskId }`. Es idempotente y retry-safe.\n\nSi la factura está en una moneda distinta de la de la empresa, `content.main.exchangeRate` trae el tipo de cambio de la fecha de la factura (`transactionDate`), el mismo que tomaría la web, para mostrarlo antes de crear el gasto. Si el agente cambia la moneda o la fecha antes de crearlo, debe quitar `exchangeRate` para que se calcule de nuevo.\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que devuelve un prototipo y no escribe nada, así que se puede repetir sin riesgo.",
				"operationId": "proposeBill",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						},
						"description": "Identificador del item (prefijo `tas_`)"
					}
				],
				"requestBody": {
					"required": false,
					"description": "Parámetros opcionales para afinar la propuesta.",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"additionalProperties": false,
								"properties": {
									"contactId": {
										"type": "string",
										"description": "Si se indica, el server omite el matching automático y usa este contacto."
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Prototipo de factura de compra",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "ProposeBillResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"matchedContact",
										"candidateContacts",
										"newContactProposal"
									],
									"properties": {
										"content": {
											"description": "Prototipo del documento listo para enviar a `POST /bills`. El `uuid` se omite intencionadamente — el agente debe dejarlo al server o asignar uno propio en el create.",
											"$ref": "#/components/schemas/BillWrite"
										},
										"matchedContact": {
											"nullable": true,
											"description": "Contacto único matched. `null` si hubo 0 o más de 1 candidato.",
											"$ref": "#/components/schemas/Contact"
										},
										"candidateContacts": {
											"type": "array",
											"description": "Lista de candidatos cuando el matching encontró varios. Vacío si hubo 0 o 1 match.",
											"items": {
												"$ref": "#/components/schemas/Contact"
											}
										},
										"newContactProposal": {
											"description": "Proto-contacto pre-rellenado con los datos extraídos. El agente puede crearlo vía `POST /contacts` y luego enlazarlo en el create.",
											"$ref": "#/components/schemas/Contact"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"description": "El task aún no se ha escaneado (`status != scanned`).",
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"description": "La extracción del task no es compatible con el tipo solicitado. Posibles `code` en el body: `feature_disabled` (solo en `proposePayroll`: la empresa no tiene activa `settings.features.scanPayroll`), `extraction_not_compatible` (el escaneo no produjo el shape esperado para el tipo solicitado), `no_extraction` (el task no tiene extracción)."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"inbox:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/inbox/{id}/proposeTicket": {
			"post": {
				"tags": [
					"Bandeja de entrada"
				],
				"summary": "Propuesta de ticket de compra desde un item de la bandeja",
				"description": "Construye un prototipo de ticket de compra a partir de la extracción del task. El endpoint NO crea nada en BD: devuelve el `content` ya mapeado al shape FD (líneas, impuestos, IRPF, contacto resuelto, totales) para que el agente lo revise, lo ajuste si quiere, y lo reenvíe a `POST /bills` con `fromInbox: { taskId }`. Es idempotente y retry-safe.\n\nSi la factura está en una moneda distinta de la de la empresa, `content.main.exchangeRate` trae el tipo de cambio de la fecha de la factura (`transactionDate`), el mismo que tomaría la web, para mostrarlo antes de crear el gasto. Si el agente cambia la moneda o la fecha antes de crearlo, debe quitar `exchangeRate` para que se calcule de nuevo.\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura que devuelve un prototipo y no escribe nada, así que se puede repetir sin riesgo.",
				"operationId": "proposeTicket",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"schema": {
							"type": "string"
						},
						"description": "Identificador del item (prefijo `tas_`)"
					}
				],
				"requestBody": {
					"required": false,
					"description": "Parámetros opcionales para afinar la propuesta.",
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"additionalProperties": false,
								"properties": {
									"contactId": {
										"type": "string",
										"description": "Si se indica, el server omite el matching automático y usa este contacto."
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Prototipo de ticket de compra",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "ProposeTicketResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"matchedContact",
										"candidateContacts",
										"newContactProposal"
									],
									"properties": {
										"content": {
											"description": "Prototipo del documento listo para enviar a `POST /bills`. El `uuid` se omite intencionadamente — el agente debe dejarlo al server o asignar uno propio en el create.",
											"$ref": "#/components/schemas/BillWrite"
										},
										"matchedContact": {
											"nullable": true,
											"description": "Contacto único matched. `null` si hubo 0 o más de 1 candidato.",
											"$ref": "#/components/schemas/Contact"
										},
										"candidateContacts": {
											"type": "array",
											"description": "Lista de candidatos cuando el matching encontró varios. Vacío si hubo 0 o 1 match.",
											"items": {
												"$ref": "#/components/schemas/Contact"
											}
										},
										"newContactProposal": {
											"description": "Proto-contacto pre-rellenado con los datos extraídos. El agente puede crearlo vía `POST /contacts` y luego enlazarlo en el create.",
											"$ref": "#/components/schemas/Contact"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"409": {
						"description": "El task aún no se ha escaneado (`status != scanned`).",
						"$ref": "#/components/responses/ConflictError"
					},
					"422": {
						"description": "La extracción del task no es compatible con el tipo solicitado. Posibles `code` en el body: `feature_disabled` (solo en `proposePayroll`: la empresa no tiene activa `settings.features.scanPayroll`), `extraction_not_compatible` (el escaneo no produjo el shape esperado para el tipo solicitado), `no_extraction` (el task no tiene extracción)."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"inbox:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/activity": {
			"get": {
				"tags": [
					"Actividad"
				],
				"summary": "Registro de actividad de la empresa",
				"description": "Devuelve la actividad de la empresa: altas, modificaciones y eliminaciones de documentos, envíos por email, accesos de los usuarios, sincronizaciones bancarias, envíos a la AEAT, tareas automáticas, cambios de ajustes… Es la misma información de la página de actividad. Usa paginación por cursor.\n\nExige el permiso de actividad completo en el rol del usuario: el nivel «solo la suya» no da acceso por la API.",
				"operationId": "getActivity",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					},
					{
						"name": "type",
						"in": "query",
						"required": false,
						"description": "Tipos de actividad a incluir. Si se indican varios, se incluye la actividad de cualquiera de ellos.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"inserted",
									"updated",
									"archived",
									"unarchived",
									"comment_inserted",
									"comment_updated",
									"comment_archived",
									"paymentRefund",
									"file",
									"portalView",
									"portalPaymentFinalizeFailed",
									"deliveryReceiptSigned",
									"scannedFile",
									"parsedFacturae",
									"send",
									"send_queued",
									"send_delivered",
									"send_dropped",
									"send_complained",
									"send_failed_temporary",
									"send_failed_permanent",
									"smtpCustomServerAutoDisabled",
									"afterbanks",
									"afterbanksWarning",
									"bankSync",
									"bankSyncWarning",
									"ticketbai_accepted",
									"ticketbai_rejected",
									"ticketbai_error",
									"verifactu_send_aeat",
									"verifactu_send_invoice",
									"verifactu_send_requerimiento",
									"verifactu_export_records",
									"verifactu_export_events",
									"face_send_invoice",
									"face_adopt_registration",
									"face_refresh_status",
									"face_cancel_invoice",
									"accounting_export",
									"automation",
									"automationError",
									"automationInfo",
									"automationAutoDeactivated",
									"automationReactivated",
									"automationReport",
									"access",
									"updateSettings",
									"leaveCompany",
									"addSupportUser",
									"archiveCompany",
									"unarchiveCompany",
									"classicImport",
									"certificateExpirationEmail",
									"usageMeterReset",
									"usageQuotaWarning",
									"usageCreditGrant",
									"usageCreditPurchase",
									"usageCreditChargeback",
									"usageCreditAdjustment",
									"webhook",
									"webhook_endpoint_created",
									"webhook_endpoint_updated",
									"webhook_endpoint_deleted",
									"webhook_endpoint_enabled",
									"webhook_endpoint_disabled",
									"webhook_endpoint_warning",
									"webhook_secret_rotated",
									"report_subscription_created",
									"report_subscription_updated",
									"report_subscription_paused",
									"report_subscription_resumed",
									"report_subscription_deleted",
									"report_subscription_sent",
									"report_subscription_failed",
									"report_export",
									"partnerAccountConverted",
									"partnerCollectionPastDue",
									"partnerCollectionSuspended",
									"partnerCollectionRestored",
									"partnerCollectionTerminated",
									"partnerCollectionReset",
									"partnerOpenInvoicesPaid",
									"partnerDelegatedCompanyReleased",
									"partnerDelegatedRenewalReverted",
									"partnerContractGenerated",
									"delegatedRenewalHeld",
									"delegatedRenewalRestored",
									"delegatedBillingReleased",
									"delegatedRenewalReverted",
									"automaticPayment",
									"classicWebhook",
									"inbox",
									"internal",
									"migration",
									"voided",
									"unvoided"
								]
							}
						}
					},
					{
						"name": "username",
						"in": "query",
						"required": false,
						"description": "Usuarios (email) que registraron la actividad. Si se indican varios, se incluye la de cualquiera de ellos.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "documentId",
						"in": "query",
						"required": false,
						"description": "Identificador del elemento al que se refiere la actividad (por ejemplo, `inv_…` para una factura). Devuelve el historial de ese elemento.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "documentType",
						"in": "query",
						"required": false,
						"description": "Tipos del documento al que se refiere la actividad (`invoice`, `bill`, `contact`…). Si se indican varios, se incluye la actividad de cualquiera de ellos.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string"
							}
						}
					},
					{
						"name": "minDate",
						"in": "query",
						"required": false,
						"description": "Fecha y hora mínima de la actividad, incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta desde el inicio de ese día en la zona horaria de la empresa.",
						"allowReserved": true,
						"schema": {
							"type": "string",
							"anyOf": [
								{
									"type": "string",
									"format": "date"
								},
								{
									"type": "string",
									"format": "date-time"
								}
							]
						}
					},
					{
						"name": "maxDate",
						"in": "query",
						"required": false,
						"description": "Fecha y hora máxima de la actividad, incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta hasta el final de ese día en la zona horaria de la empresa.",
						"allowReserved": true,
						"schema": {
							"type": "string",
							"anyOf": [
								{
									"type": "string",
									"format": "date"
								},
								{
									"type": "string",
									"format": "date-time"
								}
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de actividad",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetActivityResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/Activity"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más resultados detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más resultados."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Acota la búsqueda con `minDate` y `maxDate` o con más filtros."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"activity:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/search": {
			"get": {
				"tags": [
					"Búsqueda"
				],
				"summary": "Búsqueda global de documentos",
				"description": "Busca un texto en contactos, facturas, presupuestos, albaranes, pedidos, órdenes de compra, facturas de compra y tickets, nóminas, productos y facturas recurrentes a la vez, con el mismo criterio que la búsqueda rápida de la aplicación: todas las palabras, sin distinguir acentos ni mayúsculas, en el texto del documento (título, líneas, notas) y en el nombre de su contacto, y además, si el texto lleva alguna cifra, en el número del documento normalizado (`F-2026-12` encuentra `F-2026-0012`). La referencia de las facturas de compra y tickets se compara siempre.\n\nDevuelve hasta `limitPerType` resultados por tipo, agrupados en el orden de `groups`; dentro de cada tipo, primero las coincidencias de número y después de más reciente a más antiguo. `hasMore` indica que el tipo tiene más resultados: el listado del recurso con su parámetro `search` los devuelve todos, paginados. Los archivados no se incluyen.\n\nNo exige un scope concreto: entra cada tipo cuyo scope de lectura tiene el token (`contacts:read`, `invoices:read`…), con las mismas reglas que su listado (rol del usuario con OAuth, facetas de contacto permitidas, facturas recurrentes solo con `recurring:read` e `invoices:read`). Sin ningún scope de lectura responde `403`.\n\nLa búsqueda tiene un tope de tiempo: en una empresa con cientos de miles de documentos, un texto que no aparece en los recientes puede superarlo, y entonces responde `422` con `search_query_timeout`. Acótala con `types` o con un texto más concreto.",
				"operationId": "search",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "q",
						"in": "query",
						"description": "Texto a buscar (obligatorio): nombre, NIF o email de un contacto, número o referencia de un documento, texto de sus líneas, nombre o referencia de un producto…",
						"schema": {
							"type": "string",
							"minLength": 2,
							"maxLength": 200
						}
					},
					{
						"name": "types",
						"in": "query",
						"description": "Recursos a los que acotar la búsqueda (`invoices`, `contacts`…), varios separados por comas (`types=invoices,contacts`) o repitiendo el parámetro. Sin indicar, todos los que el token puede leer.",
						"schema": {
							"type": "array",
							"items": {
								"type": "string",
								"enum": [
									"contacts",
									"invoices",
									"estimates",
									"deliveryNotes",
									"clientOrders",
									"purchaseOrders",
									"bills",
									"payrolls",
									"products",
									"recurring"
								]
							}
						},
						"style": "form",
						"explode": true
					},
					{
						"name": "limitPerType",
						"in": "query",
						"description": "Resultados por tipo, de 1 a 20 (por defecto 5)",
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 20
						}
					}
				],
				"responses": {
					"200": {
						"description": "Resultados agrupados por tipo",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "SearchResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"groups"
									],
									"properties": {
										"items": {
											"type": "array",
											"description": "Resultados, en el orden de `groups` y, dentro de cada tipo, coincidencias de número primero y después de más reciente a más antiguo",
											"items": {
												"$ref": "#/components/schemas/SearchResultItem"
											}
										},
										"groups": {
											"type": "array",
											"description": "Tipos con algún resultado, en el orden en que se presentan",
											"items": {
												"type": "object",
												"title": "SearchResultGroup",
												"additionalProperties": false,
												"required": [
													"type",
													"resource",
													"hasMore"
												],
												"properties": {
													"type": {
														"type": "string",
														"enum": [
															"contact",
															"invoice",
															"estimate",
															"deliveryNote",
															"clientOrder",
															"purchaseOrder",
															"bill",
															"payroll",
															"product",
															"automation"
														],
														"description": "Tipo de documento"
													},
													"resource": {
														"type": "string",
														"enum": [
															"contacts",
															"invoices",
															"estimates",
															"deliveryNotes",
															"clientOrders",
															"purchaseOrders",
															"bills",
															"payrolls",
															"products",
															"recurring"
														],
														"description": "Recurso de la API con el que se lista y se lee ese tipo (`recurring` son las facturas recurrentes, `GET /recurring/invoices`)"
													},
													"hasMore": {
														"type": "boolean",
														"description": "Hay más resultados de este tipo que los devueltos: el listado del recurso con `search` los devuelve todos"
													}
												}
											}
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"422": {
						"description": "La búsqueda ha tardado demasiado (`code`: `search_query_timeout`). Acótala con `types` o con un texto más concreto."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"contacts:read",
							"invoices:read",
							"estimates:read",
							"deliveryNotes:read",
							"clientOrders:read",
							"purchaseOrders:read",
							"bills:read",
							"payrolls:read",
							"products:read",
							"recurring:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/query": {
			"post": {
				"tags": [
					"Consultas"
				],
				"summary": "Consulta analítica",
				"description": "Agrega los datos de la empresa en una sola llamada: una fuente, hasta 10 medidas, hasta 2 dimensiones, filtros, un periodo con comparativa o desglose, orden y límite. Responde una tabla: `columns` describe cada clave de las filas, `rows` son los grupos ordenados, `totals` el conjunto filtrado completo y `other` lo que queda fuera de `limit`. Es la forma de responder «¿quiénes son mis cinco mejores clientes?», «¿cuánto suman las facturas vencidas?» o «¿qué provincias facturan más que el año pasado?» sin paginar listados.\n\n**Fuentes.** Cada fuente se llama como el recurso de la API cuyo listado devolvería esos documentos y sus cifras son las de los documentos; `invoiceLines` y `billLines` son sus líneas, con el producto. La contabilidad es solo `journal`. No existen fuentes genéricas (`sales`, `purchases`).\n\n* **`invoices`** (documentos, scope `invoices:read`): Facturas de venta definitivas, no anuladas y no archivadas, con los importes del documento (base, impuestos, total y pendiente). Las anuladas entran solo con un filtro `state` que las pida. Las simplificadas (sin identificador fiscal del destinatario) entran como las demás, salvo que el filtro `simplified` las separe, y las sustitutivas de simplificadas (F3) no entran nunca: repiten las ventas de las simplificadas que sustituyen y no tienen contabilidad. Un apunte manual de ventas no está aquí: está en `journal`.\n  * Medidas: `count`, `contacts`, `totalBeforeTaxes`, `taxes`, `indirectTaxes`, `retentions`, `gross`, `total`, `pending`, `average`, `daysToPayment`, `daysOverdue`\n  * Dimensiones: `contact`, `contact.region`, `contact.country`, `fiscalId`, `country`, `series`, `currency`, `state`, `paymentMethod`, `agingBucket`, `day`, `week`, `month`, `quarter`, `year`\n  * Filtros: `contact` (eq, in), `contact.region` (eq, in), `contact.country` (eq, in), `fiscalId` (eq, in), `country` (eq, in), `series` (eq, in), `currency` (eq, in), `state` (eq, in), `paymentMethod` (eq, in), `total` (gte, lte, between), `totalBeforeTaxes` (gte, lte, between), `dueDate` (gte, lte, between), `tag` (eq, in), `draft` (eq), `simplified` (eq)\n* **`invoiceLines`** (documentos, scope `invoices:read`): Líneas de las facturas de `invoices` (definitivas, no anuladas, no archivadas y sin las sustitutivas de simplificadas), con su producto, su cantidad y su importe sin impuestos. Las líneas sin cantidad, como las de solo texto, no entran. Es la fuente de «¿qué producto vendo más?».\n  * Medidas: `count`, `documents`, `contacts`, `quantity`, `totalBeforeTaxes`, `averagePrice`, `cost`, `margin`, `marginRate`\n  * Dimensiones: `product`, `account`, `contact`, `contact.region`, `contact.country`, `fiscalId`, `country`, `series`, `currency`, `day`, `week`, `month`, `quarter`, `year`\n  * Filtros: `product` (eq, in), `hasProduct` (eq), `account` (eq, in, startsWith), `contact` (eq, in), `contact.region` (eq, in), `contact.country` (eq, in), `fiscalId` (eq, in), `country` (eq, in), `series` (eq, in), `currency` (eq, in), `tag` (eq, in), `draft` (eq), `simplified` (eq)\n* **`bills`** (documentos, scope `bills:read`): Facturas de compra y tickets definitivos, no anulados y no archivados, con los importes del documento. Los anulados entran solo con un filtro `state` que los pida. Las nóminas y las amortizaciones no están aquí: están en `journal`.\n  * Medidas: `count`, `contacts`, `totalBeforeTaxes`, `taxes`, `indirectTaxes`, `retentions`, `gross`, `total`, `pending`, `average`, `daysToPayment`, `daysOverdue`\n  * Dimensiones: `contact`, `contact.region`, `contact.country`, `fiscalId`, `country`, `series`, `currency`, `state`, `paymentMethod`, `agingBucket`, `day`, `week`, `month`, `quarter`, `year`, `account`\n  * Filtros: `contact` (eq, in), `contact.region` (eq, in), `contact.country` (eq, in), `fiscalId` (eq, in), `country` (eq, in), `series` (eq, in), `currency` (eq, in), `state` (eq, in), `paymentMethod` (eq, in), `total` (gte, lte, between), `totalBeforeTaxes` (gte, lte, between), `dueDate` (gte, lte, between), `tag` (eq, in), `draft` (eq), `account` (eq, in, startsWith)\n* **`billLines`** (documentos, scope `bills:read`): Líneas de las facturas de compra y tickets de `bills` (definitivos, no anulados y no archivados), con su producto, su cantidad, su importe sin impuestos y su cuenta de gasto. Las líneas sin cantidad no entran.\n  * Medidas: `count`, `documents`, `contacts`, `quantity`, `totalBeforeTaxes`, `averagePrice`\n  * Dimensiones: `product`, `account`, `contact`, `contact.region`, `contact.country`, `fiscalId`, `country`, `series`, `currency`, `day`, `week`, `month`, `quarter`, `year`\n  * Filtros: `product` (eq, in), `hasProduct` (eq), `account` (eq, in, startsWith), `contact` (eq, in), `contact.region` (eq, in), `contact.country` (eq, in), `fiscalId` (eq, in), `country` (eq, in), `series` (eq, in), `currency` (eq, in), `tag` (eq, in), `draft` (eq)\n* **`contacts`** (documentos, scope `contacts:read`): Contactos no archivados que la credencial puede ver (clientes, proveedores y empleados según sus permisos).\n  * Medidas: `count`\n  * Dimensiones: `address.region`, `address.country`, `fiscalId`, `isClient`, `isProvider`, `isEmployee`, `createdMonth`\n  * Filtros: `address.region` (eq, in), `address.country` (eq, in), `fiscalId` (eq, in), `isClient` (eq), `isProvider` (eq), `isEmployee` (eq), `tag` (eq, in)\n* **`journal`** (contabilidad, scope `accounting:read`): Apuntes del diario de todos los documentos y asientos, sin los asientos de mantenimiento (apertura, regularización y cierre). Es la única fuente contable: aquí están las ventas de las cuentas 7, incluidos los apuntes manuales, y los gastos de las cuentas 6.\n  * Medidas: `count`, `debit`, `credit`, `balance`, `net`, `income`, `expenses`, `result`\n  * Dimensiones: `account`, `account.group`, `account.subgroup`, `account.code`, `thirdParty`, `contact`, `category`, `documentType`, `day`, `week`, `month`, `quarter`, `year`\n  * Filtros: `account` (eq, in, startsWith), `thirdParty` (eq, in), `contact` (eq, in), `category` (eq, in), `documentType` (eq, in)\n\n**Medidas de tiempo** (`daysToPayment`, `daysOverdue`): la agregación va como sufijo, `daysToPayment.median`; sin sufijo, la media. Admiten `avg`, `median`, `p90`, `min`, `max` y `count`.\n\n**Planes.** Dos grupos de nombres dependen del plan de la empresa: los cobros y pagos a fondo (`daysToPayment`, `daysOverdue`, `agingBucket`; planes Bronce / Plata / Oro / Diamante) y el margen (`cost`, `margin`, `marginRate`; planes Bronce / Plata / Oro / Diamante). Siguen en el vocabulario, pero pedirlos sin la funcionalidad responde `403` con `code: plan_limit_exceeded` y la funcionalidad que falta en `hint.features` (`collectionsAnalytics` o `marginAnalytics`), igual en la aplicación, la API pública y el MCP. Un administrador de la empresa puede ampliar el plan en FacturaDirecta.\n\n**Periodo.** `period.start` y `period.end` (`YYYY-MM-DD`, incluidos), por defecto el año natural en curso, como máximo 5 años. Acota por la fecha del documento (`invoices`, `bills` y sus líneas) o del apunte (`journal`). En `contacts` acota por la fecha de alta, es opcional y no tiene tope: sin `period` entran todos los contactos («¿cuántos clientes tengo por provincia?»), y `compare` y `breakdown` lo necesitan. `compare` añade a cada medida las columnas `<medida>_reference`, `_difference` y `_variance` con el periodo anterior de la misma duración (`previousPeriod`) o el mismo periodo del año anterior (`previousYear`). `breakdown` añade la dimensión `period` con un tramo por mes, trimestre o año natural (hasta 24). No se combinan.\n\n**Moneda.** Con multimoneda, `currency` es una dimensión implícita en `invoices`, `bills` y sus líneas cuando la consulta pide importes: los importes nunca se mezclan, salvo con `amounts: \"company\"`, que los da en la moneda de la empresa. Una consulta sin importes (documentos, cantidades, días) no se separa por moneda. En `journal` los importes van en la moneda de la empresa.\n\n**Filas.** `limit` entre 1 y 500 (por defecto 10), ordenadas por `orderBy` o por la primera medida de mayor a menor. Con dos dimensiones, `limitPerGroup` deja como máximo esas filas de la segunda dentro de cada valor de la primera («los cinco productos más vendidos de cada cliente»). Las dimensiones de entidad (`contact`, `product`, `fiscalId`, `thirdParty`, `paymentMethod`, `account`, las provincias) valen `{ id, name }`; las de tiempo, `{ id, start, end }`. Un nombre fuera del vocabulario responde `400` con el nombre más parecido. Cada consulta tiene un tope de 30 segundos: pasado, responde `422` con `report_query_timeout`.\n\n**Permisos.** Exige el scope de lectura de la fuente (`invoices:read`, `bills:read`, `contacts:read` o `accounting:read`), con las mismas reglas que su listado: en `contacts`, solo las facetas que la conexión permite. Sin el scope responde `403` con `token_scope_missing`. Las cifras de cobros a fondo y de margen exigen además la funcionalidad del plan (ver **Planes**): sin ella responde `403` con `plan_limit_exceeded`.\n\n\n\nEsta operación no admite la cabecera `Idempotency-Key` (si se envía, se ignora): es una lectura: repetirla no cambia nada",
				"operationId": "analyticsQuery",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"type": "object",
								"title": "AnalyticsQueryRequest",
								"additionalProperties": false,
								"required": [
									"from"
								],
								"properties": {
									"from": {
										"type": "string",
										"enum": [
											"invoices",
											"invoiceLines",
											"bills",
											"billLines",
											"contacts",
											"journal"
										],
										"description": "Fuente de la consulta"
									},
									"measures": {
										"type": "array",
										"maxItems": 10,
										"items": {
											"type": "string",
											"maxLength": 64
										},
										"description": "Medidas de la fuente, con el sufijo de agregación en las de días (`daysToPayment.median`). Sin indicar, la medida por defecto de la fuente."
									},
									"dimensions": {
										"type": "array",
										"maxItems": 2,
										"items": {
											"type": "string",
											"maxLength": 64
										},
										"description": "Dimensiones por las que agrupar, en orden. Sin indicar, una sola fila con los totales."
									},
									"period": {
										"type": "object",
										"additionalProperties": false,
										"properties": {
											"start": {
												"type": "string",
												"format": "date",
												"description": "Primer día del periodo, incluido. Por defecto, el 1 de enero del año en curso."
											},
											"end": {
												"type": "string",
												"format": "date",
												"description": "Último día del periodo, incluido. Por defecto, el 31 de diciembre del año en curso."
											}
										},
										"description": "Fechas del documento (`invoices`, `bills`), del apunte (`journal`) o de alta (`contacts`). En `contacts` es opcional: sin él entran todos los contactos."
									},
									"compare": {
										"type": "string",
										"enum": [
											"none",
											"previousPeriod",
											"previousYear"
										],
										"description": "Periodo de referencia que se añade a cada medida. No se combina con `breakdown`."
									},
									"breakdown": {
										"type": "string",
										"enum": [
											"none",
											"month",
											"quarter",
											"year"
										],
										"description": "Divide el periodo en tramos naturales, como la dimensión `period`. No se combina con `compare`."
									},
									"filters": {
										"type": "array",
										"maxItems": 10,
										"items": {
											"type": "object",
											"additionalProperties": false,
											"required": [
												"field",
												"op"
											],
											"properties": {
												"field": {
													"type": "string",
													"maxLength": 64,
													"description": "Filtro de la fuente"
												},
												"op": {
													"type": "string",
													"enum": [
														"eq",
														"in",
														"gte",
														"lte",
														"between",
														"startsWith"
													]
												},
												"value": {
													"description": "Valor para `eq`, `gte`, `lte` y `startsWith`",
													"oneOf": [
														{
															"type": "string",
															"maxLength": 256
														},
														{
															"type": "number"
														},
														{
															"type": "boolean"
														}
													]
												},
												"values": {
													"type": "array",
													"maxItems": 100,
													"items": {
														"oneOf": [
															{
																"type": "string",
																"maxLength": 256
															},
															{
																"type": "number"
															}
														]
													},
													"description": "Valores para `in` (lista) y `between` (dos valores, ambos incluidos)"
												}
											}
										}
									},
									"orderBy": {
										"type": "array",
										"maxItems": 4,
										"items": {
											"type": "object",
											"additionalProperties": false,
											"required": [
												"field"
											],
											"properties": {
												"field": {
													"type": "string",
													"maxLength": 64,
													"description": "Medida o dimensión de la consulta"
												},
												"direction": {
													"type": "string",
													"enum": [
														"asc",
														"desc"
													],
													"description": "Por defecto `desc`"
												}
											}
										}
									},
									"limit": {
										"type": "integer",
										"minimum": 1,
										"maximum": 500,
										"description": "Filas como máximo (por defecto 10)"
									},
									"limitPerGroup": {
										"type": "integer",
										"minimum": 1,
										"maximum": 500,
										"description": "Con dos dimensiones, filas como máximo de la segunda dentro de cada valor de la primera: las primeras por las medidas de `orderBy` (o por la primera medida, de mayor a menor). No se combina con `compare`, `breakdown` ni `includeOther`"
									},
									"includeOther": {
										"type": "boolean",
										"description": "Añade `other` con la suma de los grupos que quedan fuera de `limit`"
									},
									"amounts": {
										"type": "string",
										"enum": [
											"document",
											"company"
										],
										"description": "Moneda de los importes en `invoices`, `bills` y sus líneas: `document` (por defecto), cada importe en la de su documento, con la moneda como dimensión implícita si hay varias; `company`, el contravalor de cada documento en la moneda de la empresa (`meta.currency`), en un solo grupo aunque haya varias monedas. `pending` solo admite `document`."
									}
								}
							},
							"examples": {
								"topClients": {
									"summary": "Los cinco mejores clientes del año",
									"value": {
										"from": "invoices",
										"measures": [
											"totalBeforeTaxes",
											"count"
										],
										"dimensions": [
											"contact"
										],
										"limit": 5,
										"includeOther": true
									}
								},
								"topClientsByFiscalId": {
									"summary": "Los mejores clientes por identificador fiscal, reuniendo los contactos duplicados",
									"value": {
										"from": "invoices",
										"measures": [
											"totalBeforeTaxes",
											"contacts"
										],
										"dimensions": [
											"fiscalId"
										],
										"limit": 5
									}
								},
								"overdueInvoices": {
									"summary": "Facturas vencidas y cuánto suman",
									"value": {
										"from": "invoices",
										"measures": [
											"count",
											"total",
											"pending"
										],
										"filters": [
											{
												"field": "state",
												"op": "in",
												"values": [
													"overdue"
												]
											}
										]
									}
								},
								"expensesByProvider": {
									"summary": "Gastos de un mes por proveedor",
									"value": {
										"from": "bills",
										"measures": [
											"totalBeforeTaxes",
											"count"
										],
										"dimensions": [
											"contact"
										],
										"period": {
											"start": "2026-09-01",
											"end": "2026-09-30"
										},
										"limit": 100
									}
								},
								"provincesCompared": {
									"summary": "Provincias con más facturación, frente al periodo anterior",
									"value": {
										"from": "invoices",
										"measures": [
											"totalBeforeTaxes"
										],
										"dimensions": [
											"contact.region"
										],
										"period": {
											"start": "2026-01-01",
											"end": "2026-06-30"
										},
										"compare": "previousPeriod",
										"limit": 5
									}
								},
								"clientsByProvince": {
									"summary": "Provincias con más clientes",
									"value": {
										"from": "contacts",
										"measures": [
											"count"
										],
										"dimensions": [
											"address.region"
										],
										"filters": [
											{
												"field": "isClient",
												"op": "eq",
												"value": true
											}
										],
										"limit": 5
									}
								},
								"salesAccountsByContact": {
									"summary": "Ventas de las cuentas 7 por cliente, asientos manuales incluidos",
									"value": {
										"from": "journal",
										"measures": [
											"net"
										],
										"dimensions": [
											"contact"
										],
										"filters": [
											{
												"field": "account",
												"op": "startsWith",
												"value": "7"
											}
										],
										"limit": 5
									}
								},
								"monthlyResult": {
									"summary": "Resultado del año mes a mes",
									"value": {
										"from": "journal",
										"measures": [
											"income",
											"expenses",
											"result"
										],
										"breakdown": "month",
										"limit": 12
									}
								},
								"daysToPayment": {
									"summary": "Días medios de cobro por cliente",
									"value": {
										"from": "invoices",
										"measures": [
											"daysToPayment",
											"daysToPayment.median",
											"count"
										],
										"dimensions": [
											"contact"
										],
										"orderBy": [
											{
												"field": "daysToPayment",
												"direction": "desc"
											}
										],
										"limit": 10
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Resultado de la consulta",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/AnalyticsQueryResponse"
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:read",
							"bills:read",
							"contacts:read",
							"accounting:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}/versions": {
			"get": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Versiones de la factura",
				"description": "Historial de versiones de la factura: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/invoices/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getInvoiceVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de la factura (`inv_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetInvoiceVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/invoices/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Facturas de venta"
				],
				"summary": "Versión de la factura",
				"description": "Copia de la factura tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/invoices/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getInvoiceVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de la factura (`inv_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetInvoiceVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Invoice"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"invoices:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/estimates/{id}/versions": {
			"get": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Versiones de el presupuesto",
				"description": "Historial de versiones de el presupuesto: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/estimates/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getEstimateVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el presupuesto (`est_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetEstimateVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/estimates/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Presupuestos"
				],
				"summary": "Versión de el presupuesto",
				"description": "Copia de el presupuesto tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/estimates/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getEstimateVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el presupuesto (`est_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetEstimateVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Estimate"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"estimates:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/deliveryNotes/{id}/versions": {
			"get": {
				"tags": [
					"Albaranes"
				],
				"summary": "Versiones de el albarán",
				"description": "Historial de versiones de el albarán: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/deliveryNotes/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getDeliveryNoteVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el albarán (`den_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetDeliveryNoteVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/deliveryNotes/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Albaranes"
				],
				"summary": "Versión de el albarán",
				"description": "Copia de el albarán tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/deliveryNotes/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getDeliveryNoteVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el albarán (`den_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetDeliveryNoteVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/DeliveryNote"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"deliveryNotes:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/clientOrders/{id}/versions": {
			"get": {
				"tags": [
					"Pedidos"
				],
				"summary": "Versiones de el pedido",
				"description": "Historial de versiones de el pedido: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/clientOrders/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getClientOrderVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el pedido (`cor_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetClientOrderVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/clientOrders/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Pedidos"
				],
				"summary": "Versión de el pedido",
				"description": "Copia de el pedido tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/clientOrders/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getClientOrderVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el pedido (`cor_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetClientOrderVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/ClientOrder"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"clientOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/bills/{id}/versions": {
			"get": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Versiones de la factura de compra o el ticket",
				"description": "Historial de versiones de la factura de compra o el ticket: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/bills/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getBillVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de la factura de compra o el ticket (`bil_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetBillVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/bills/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Facturas de compra y tickets"
				],
				"summary": "Versión de la factura de compra o el ticket",
				"description": "Copia de la factura de compra o el ticket tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/bills/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getBillVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de la factura de compra o el ticket (`bil_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetBillVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Bill"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"bills:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/purchaseOrders/{id}/versions": {
			"get": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Versiones de la orden de compra",
				"description": "Historial de versiones de la orden de compra: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/purchaseOrders/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getPurchaseOrderVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de la orden de compra (`pur_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPurchaseOrderVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/purchaseOrders/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Órdenes de compra"
				],
				"summary": "Versión de la orden de compra",
				"description": "Copia de la orden de compra tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/purchaseOrders/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getPurchaseOrderVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de la orden de compra (`pur_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPurchaseOrderVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/PurchaseOrder"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"purchaseOrders:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/contacts/{id}/versions": {
			"get": {
				"tags": [
					"Contactos"
				],
				"summary": "Versiones de el contacto",
				"description": "Historial de versiones de el contacto: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/contacts/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getContactVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el contacto (`con_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetContactVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"contacts:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/contacts/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Contactos"
				],
				"summary": "Versión de el contacto",
				"description": "Copia de el contacto tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/contacts/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getContactVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el contacto (`con_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetContactVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Contact"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"contacts:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/products/{id}/versions": {
			"get": {
				"tags": [
					"Productos"
				],
				"summary": "Versiones de el producto",
				"description": "Historial de versiones de el producto: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/products/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getProductVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el producto (`pro_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetProductVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/products/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Productos"
				],
				"summary": "Versión de el producto",
				"description": "Copia de el producto tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/products/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getProductVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el producto (`pro_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetProductVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Product"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"products:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/banks/{id}/versions": {
			"get": {
				"tags": [
					"Bancos"
				],
				"summary": "Versiones de el banco",
				"description": "Historial de versiones de el banco: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/banks/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getBankVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el banco (`ban_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetBankVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"banks:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/banks/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Bancos"
				],
				"summary": "Versión de el banco",
				"description": "Copia de el banco tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/banks/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getBankVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el banco (`ban_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetBankVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Bank"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"banks:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/paymentMethods/{id}/versions": {
			"get": {
				"tags": [
					"Métodos de pago"
				],
				"summary": "Versiones de el método de pago",
				"description": "Historial de versiones de el método de pago: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/paymentMethods/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getPaymentMethodVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el método de pago (`pam_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPaymentMethodVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"paymentMethods:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/paymentMethods/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Métodos de pago"
				],
				"summary": "Versión de el método de pago",
				"description": "Copia de el método de pago tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/paymentMethods/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getPaymentMethodVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de el método de pago (`pam_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPaymentMethodVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/PaymentMethod"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"paymentMethods:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/payrolls/{id}/versions": {
			"get": {
				"tags": [
					"Nóminas"
				],
				"summary": "Versiones de la nómina",
				"description": "Historial de versiones de la nómina: su alta, cada modificación, su eliminación y su recuperación, con quién y cuándo. Cada versión guarda una copia completa del documento, que se consulta con `GET /{companyId}/payrolls/{id}/versions/{versionId}`. Incluye las versiones de documentos eliminados. Usa paginación por cursor.",
				"operationId": "getPayrollVersions",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de la nómina (`par_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"description": "Número máximo de resultados, entre 1 y 100. Por defecto, 50.",
						"required": false,
						"schema": {
							"type": "integer",
							"minimum": 1,
							"maximum": 100
						}
					},
					{
						"name": "cursor",
						"in": "query",
						"description": "Cursor de paginación: el `nextCursor` de la página anterior, tal cual se recibió. Devuelve la página que va detrás de ella en el orden pedido. Para la primera página, se omite.",
						"required": false,
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "sortBy",
						"in": "query",
						"required": false,
						"description": "Orden por fecha y hora: `-timestamp` (por defecto) devuelve primero lo más reciente; `timestamp`, lo más antiguo. A igual fecha, se ordena por `id`.",
						"schema": {
							"type": "string",
							"enum": [
								"-timestamp",
								"timestamp"
							]
						}
					}
				],
				"responses": {
					"200": {
						"description": "Página de versiones",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPayrollVersionsResponse",
									"additionalProperties": false,
									"required": [
										"items",
										"hasMore",
										"nextCursor"
									],
									"properties": {
										"items": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersion"
											}
										},
										"hasMore": {
											"type": "boolean",
											"description": "Indica si hay más versiones detrás de esta página."
										},
										"nextCursor": {
											"type": "string",
											"nullable": true,
											"description": "Cursor de la página siguiente: se pasa tal cual en `cursor` para pedirla. Es `null` cuando no hay más versiones."
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		},
		"/{companyId}/payrolls/{id}/versions/{versionId}": {
			"get": {
				"tags": [
					"Nóminas"
				],
				"summary": "Versión de la nómina",
				"description": "Copia de la nómina tal como quedó en esa versión, en el mismo formato que `GET /{companyId}/payrolls/{id}`, y, si es una modificación, sus cambios respecto a la versión anterior. La copia es la que se guardó entonces: la de un documento antiguo puede no cumplir el esquema actual.\n\nPara recuperar datos de una versión, envíalos con la operación de modificación del recurso: se aplican las mismas validaciones y restricciones que a cualquier modificación (por ejemplo, una factura ya enviada a VeriFactu o TicketBAI no se puede modificar, se corrige con una rectificativa).",
				"operationId": "getPayrollVersion",
				"parameters": [
					{
						"$ref": "#/components/parameters/Accept-Version"
					},
					{
						"$ref": "#/components/parameters/CompanyId"
					},
					{
						"name": "id",
						"in": "path",
						"required": true,
						"description": "Identificador de la nómina (`par_…`). Puede estar eliminado.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "versionId",
						"in": "path",
						"required": true,
						"description": "Identificador de la versión",
						"schema": {
							"type": "integer",
							"minimum": 1
						}
					}
				],
				"responses": {
					"200": {
						"description": "Versión del documento",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"title": "GetPayrollVersionResponse",
									"additionalProperties": false,
									"required": [
										"content",
										"version",
										"previousVersionId",
										"changes"
									],
									"properties": {
										"content": {
											"$ref": "#/components/schemas/Payroll"
										},
										"tags": {
											"type": "array",
											"items": {
												"type": "string"
											},
											"description": "Etiquetas del documento en esa versión, si se guardaron"
										},
										"version": {
											"$ref": "#/components/schemas/DocumentVersion"
										},
										"previousVersionId": {
											"type": "integer",
											"nullable": true,
											"description": "En una modificación, la versión con la que se comparan `changes`; si no, `null`"
										},
										"changes": {
											"type": "array",
											"items": {
												"$ref": "#/components/schemas/DocumentVersionChange"
											},
											"description": "En una modificación, cada campo que cambió respecto a la versión anterior con su valor antes y después (las listas se comparan por posición). Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan, aunque están en `content`. Vacío en el resto de versiones."
										},
										"webUrl": {
											"$ref": "#/components/schemas/WebUrl"
										}
									}
								}
							}
						}
					},
					"400": {
						"$ref": "#/components/responses/BadRequestError"
					},
					"401": {
						"$ref": "#/components/responses/UnauthorizedError"
					},
					"403": {
						"$ref": "#/components/responses/ForbiddenError"
					},
					"404": {
						"$ref": "#/components/responses/NotFoundError"
					},
					"422": {
						"description": "La consulta ha tardado demasiado (`code`: `activity_query_timeout`). Inténtalo con un `limit` menor."
					},
					"500": {
						"$ref": "#/components/responses/InternalServerError"
					}
				},
				"security": [
					{
						"oAuth": [
							"payrolls:read"
						]
					},
					{
						"apiKey": []
					}
				]
			}
		}
	},
	"components": {
		"schemas": {
			"AccountCode": {
				"type": "string",
				"title": "AccountCode",
				"description": "Número de cuenta contable",
				"pattern": "^[0-9]{6}$"
			},
			"Activity": {
				"type": "object",
				"title": "Activity",
				"additionalProperties": false,
				"required": [
					"id",
					"timestamp",
					"type",
					"subtype",
					"username",
					"description",
					"document",
					"request",
					"details"
				],
				"properties": {
					"id": {
						"type": "integer",
						"description": "Identificador del registro de actividad"
					},
					"timestamp": {
						"type": "string",
						"format": "date-time",
						"description": "Fecha y hora de la actividad (ISO 8601, UTC)"
					},
					"type": {
						"type": "string",
						"description": "Tipo de actividad. Los valores conocidos son los del parámetro `type`; los registros antiguos pueden tener tipos que ya no se generan."
					},
					"subtype": {
						"type": "string",
						"nullable": true,
						"description": "Subtipo de actividad, en los tipos que lo tienen (por ejemplo, `voided` en una modificación que anula una factura)"
					},
					"username": {
						"type": "string",
						"nullable": true,
						"description": "Usuario (email) que hizo la acción. Las acciones automáticas aparecen con un usuario de sistema de FacturaDirecta (por ejemplo, `ami@facturadirecta.com` en las tareas automáticas)."
					},
					"description": {
						"type": "string",
						"description": "Descripción legible de la actividad, en español: la misma que muestra la página de actividad."
					},
					"document": {
						"type": "object",
						"nullable": true,
						"additionalProperties": false,
						"required": [
							"id",
							"type",
							"title",
							"archived"
						],
						"description": "Elemento al que se refiere la actividad (un documento, un contacto, un banco, una tarea automática…). Es `null` en la actividad de la empresa, como los accesos o los cambios de ajustes.",
						"properties": {
							"id": {
								"type": "string",
								"description": "Identificador del elemento"
							},
							"type": {
								"type": "string",
								"nullable": true,
								"description": "Tipo del documento (`invoice`, `bill`, `contact`…), o `null` si el elemento no es un documento"
							},
							"title": {
								"type": "string",
								"nullable": true,
								"description": "Título del documento (por ejemplo, el número de una factura)"
							},
							"archived": {
								"type": "boolean",
								"nullable": true,
								"description": "Si el documento está eliminado"
							}
						}
					},
					"request": {
						"type": "object",
						"nullable": true,
						"additionalProperties": false,
						"required": [
							"ip",
							"userAgent"
						],
						"description": "Origen de la petición que registró la actividad, cuando se conoce",
						"properties": {
							"ip": {
								"type": "string",
								"nullable": true,
								"description": "Dirección IP"
							},
							"userAgent": {
								"type": "string",
								"nullable": true,
								"description": "Navegador o aplicación (cabecera `User-Agent`)"
							}
						}
					},
					"details": {
						"type": "object",
						"additionalProperties": true,
						"description": "Datos propios de cada tipo de actividad: identificadores de otros elementos, resultados (estados, contadores, errores) y datos de la acción (formato, destinatarios de un envío…). Sus campos dependen del tipo y pueden ampliarse; un campo que el registro no tiene no aparece. El contenido de los documentos no se incluye: qué campos cambiaron en cada modificación y sus valores se consultan en las versiones del documento (`GET /{companyId}/<recurso>/{id}/versions`), con el `id` del registro como identificador de la versión."
					}
				}
			},
			"AnalyticsQueryColumn": {
				"type": "object",
				"title": "AnalyticsQueryColumn",
				"description": "Qué es cada clave de las filas: una dimensión o una medida, con su definición",
				"additionalProperties": false,
				"required": [
					"id",
					"kind",
					"title",
					"description",
					"type"
				],
				"properties": {
					"id": {
						"type": "string",
						"description": "Clave en cada fila: la dimensión, la medida o, con `compare`, `<medida>_reference`, `_difference` o `_variance`"
					},
					"kind": {
						"type": "string",
						"enum": [
							"dimension",
							"measure"
						]
					},
					"title": {
						"type": "string"
					},
					"description": {
						"type": "string",
						"description": "Definición de la medida o de la dimensión"
					},
					"type": {
						"type": "string",
						"enum": [
							"entity",
							"code",
							"enum",
							"boolean",
							"period",
							"bucket",
							"count",
							"number",
							"money",
							"days",
							"ratio"
						],
						"description": "Tipo del valor"
					},
					"measure": {
						"type": "string",
						"description": "Medida de la que deriva una columna de comparativa"
					},
					"period": {
						"type": "object",
						"additionalProperties": false,
						"required": [
							"start",
							"end"
						],
						"properties": {
							"start": {
								"type": "string"
							},
							"end": {
								"type": "string"
							}
						},
						"description": "Periodo de una columna de medida: el consultado o el de referencia"
					}
				}
			},
			"AnalyticsQueryResponse": {
				"type": "object",
				"title": "AnalyticsQueryResponse",
				"additionalProperties": false,
				"required": [
					"meta",
					"columns",
					"rows",
					"totals",
					"truncated"
				],
				"properties": {
					"meta": {
						"type": "object",
						"additionalProperties": false,
						"required": [
							"source",
							"basis",
							"limit",
							"generatedAt"
						],
						"properties": {
							"source": {
								"type": "string",
								"enum": [
									"invoices",
									"invoiceLines",
									"bills",
									"billLines",
									"contacts",
									"journal"
								]
							},
							"basis": {
								"type": "string",
								"enum": [
									"documents",
									"accounting"
								],
								"description": "`documents`: cifras de los documentos; `accounting`: cifras del diario"
							},
							"period": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"start",
									"end"
								],
								"properties": {
									"start": {
										"type": "string"
									},
									"end": {
										"type": "string"
									}
								},
								"description": "El periodo consultado; ausente en `contacts` sin `period` (entran todos los contactos)"
							},
							"compare": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"kind",
									"start",
									"end"
								],
								"properties": {
									"kind": {
										"type": "string",
										"enum": [
											"previousPeriod",
											"previousYear"
										]
									},
									"start": {
										"type": "string"
									},
									"end": {
										"type": "string"
									}
								}
							},
							"breakdown": {
								"type": "string",
								"enum": [
									"month",
									"quarter",
									"year"
								]
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes cuando `currency` no es una dimensión de la respuesta o cuando van en la de la empresa (`amounts: \"company\"`)"
							},
							"limit": {
								"type": "integer"
							},
							"generatedAt": {
								"type": "string",
								"format": "date-time"
							}
						}
					},
					"columns": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/AnalyticsQueryColumn"
						}
					},
					"rows": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/AnalyticsQueryRow"
						}
					},
					"totals": {
						"type": "object",
						"additionalProperties": {
							"type": "number",
							"nullable": true
						},
						"description": "Totales del conjunto filtrado completo, por medida; con `compare`, también `<medida>_reference`, `_difference` y `_variance`"
					},
					"other": {
						"type": "object",
						"additionalProperties": {
							"type": "number",
							"nullable": true
						},
						"description": "Con `includeOther` y más grupos que `limit`: `groups` (cuántos quedan fuera) y la suma de cada medida aditiva; `null` en las que no se suman. Con comparativa, cada una lleva también `<medida>_reference`, `_difference` y `_variance`: la referencia del resto es el total de referencia menos el de las filas, de modo que la tabla cuadra con `totals`"
					},
					"truncated": {
						"type": "boolean",
						"description": "Había más filas que `limit`"
					}
				}
			},
			"AnalyticsQueryRow": {
				"type": "object",
				"title": "AnalyticsQueryRow",
				"description": "Un grupo: una clave por columna. Las dimensiones de entidad valen `{ id, name, type?, webUrl? }` (los contactos llevan además `fiscalId` y `country`, y los productos `sku`), las de tiempo `{ id, start, end }`, el resto un texto, un número o un booleano; las medidas, un número o `null`",
				"additionalProperties": true
			},
			"Attachment": {
				"type": "object",
				"title": "Attachment",
				"additionalProperties": false,
				"properties": {
					"name": {
						"type": "string"
					},
					"url": {
						"type": "string"
					},
					"size": {
						"type": "integer",
						"minimum": 0
					},
					"creationTime": {
						"type": "string",
						"format": "date-time"
					},
					"contentType": {
						"type": "string"
					},
					"contentSubtype": {
						"type": "string",
						"enum": [
							"facturae",
							"inboxEmailBody"
						]
					}
				},
				"required": [
					"name",
					"url",
					"creationTime"
				]
			},
			"AttachmentWrite": {
				"title": "AttachmentWrite",
				"description": "Adjunto en escritura: un Attachment ya existente (se conserva tal cual) o una referencia `{uploadId}` a un upload creado previamente con POST /api/{companyId}/uploads.",
				"oneOf": [
					{
						"$ref": "#/components/schemas/Attachment"
					},
					{
						"type": "object",
						"additionalProperties": false,
						"required": [
							"uploadId"
						],
						"properties": {
							"uploadId": {
								"type": "string",
								"description": "Identificador del upload (`upl_<uuid>`) devuelto por POST /api/{companyId}/uploads. Cada upload solo puede vincularse a un documento."
							}
						}
					}
				]
			},
			"AutomationMeta": {
				"type": "object",
				"title": "AutomationMeta",
				"additionalProperties": false,
				"properties": {
					"autoDeactivated": {
						"type": "object",
						"title": "AutomationAutoDeactivatedMeta",
						"required": [
							"at",
							"source",
							"reason",
							"details"
						],
						"additionalProperties": false,
						"properties": {
							"at": {
								"type": "string",
								"format": "date-time"
							},
							"source": {
								"enum": [
									"executionCron",
									"report",
									"scheduleRefresh"
								]
							},
							"reason": {
								"enum": [
									"persistentErrors",
									"planLimitsExceeded"
								]
							},
							"details": {
								"type": "object",
								"required": [
									"lastSuccessAt",
									"oldestPendingAt",
									"erroringSince"
								],
								"additionalProperties": false,
								"properties": {
									"lastSuccessAt": {
										"type": "string",
										"format": "date-time",
										"nullable": true
									},
									"oldestPendingAt": {
										"type": "string",
										"format": "date-time",
										"nullable": true
									},
									"erroringSince": {
										"type": "string",
										"format": "date-time",
										"nullable": true
									},
									"consecutiveErrors": {
										"type": "integer",
										"minimum": 0
									},
									"readonlyCause": {
										"type": "string"
									},
									"enabledUntil": {
										"type": "string"
									}
								}
							}
						}
					}
				}
			},
			"Bank": {
				"type": "object",
				"title": "Bank",
				"required": [
					"main",
					"type",
					"uuid"
				],
				"additionalProperties": false,
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"bank"
						]
					},
					"uuid": {
						"type": "string"
					},
					"main": {
						"type": "object",
						"required": [
							"name",
							"currency",
							"account",
							"subtype"
						],
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string"
							},
							"subtype": {
								"type": "string",
								"enum": [
									"other",
									"iban",
									"stripe",
									"card"
								],
								"description": "Tipo de cuenta:\n\n* iban: Cuenta bancaria con IBAN\n* card: Tarjeta\n* stripe: Cuenta de Stripe. No tiene IBAN y sus movimientos no traen saldo de la entidad\n* other: Otra cuenta de tesorería (caja, efectivo…)"
							},
							"name": {
								"type": "string"
							},
							"notes": {
								"type": "string"
							},
							"iban": {
								"type": "string",
								"description": "IBAN completo del banco (Solo para cuentas son subtype=\"iban\" y presente si las credenciales utilizadas tienen acceso banks:readIban)"
							},
							"bic": {
								"type": "string"
							},
							"currency": {
								"type": "string"
							},
							"bankCode": {
								"type": "string"
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"iban4": {
								"type": "string",
								"description": "Últimos 4 dígitos del IBAN de esta cuenta (Solo para cuentas son subtype=\"iban\")"
							}
						}
					}
				}
			},
			"BankResponse": {
				"type": "object",
				"title": "BankResponse",
				"required": [
					"content",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/Bank"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "BankRelated",
						"description": "Datos adicionales del banco. Cada clave solo se incluye si se ha pedido con el parámetro `related`",
						"additionalProperties": false,
						"properties": {
							"balance": {
								"type": "object",
								"title": "BankBalance",
								"description": "Saldo contable del banco: la suma de los apuntes de su cuenta contable (`main.account`) cuyo tercero es el banco. Es el saldo que muestra la pantalla de bancos y el panel de inicio. Positivo es dinero en el banco.\n\nSin `balanceDate` incluye todos los apuntes, también los de fecha futura, como la pantalla de bancos; con `balanceDate` es el saldo al cierre de ese día.\n\n```\n{\n  \"balance\": {\n    \"balance\": 11234.56,\n    \"currency\": \"USD\",\n    \"currencyBalance\": 12400.00,\n    \"latestEntryDate\": \"2026-10-15\"\n  }\n}\n```\n\nEl ejemplo corresponde a un banco en USD de una empresa que contabiliza en EUR: tiene 12.400 USD, contabilizados como 11.234,56 EUR. En un banco en la moneda de la empresa `balance` y `currencyBalance` coinciden.",
								"required": [
									"balance",
									"currency",
									"currencyBalance",
									"latestEntryDate"
								],
								"properties": {
									"balance": {
										"type": "number",
										"description": "Saldo en la moneda de la empresa. Suma todos los apuntes del banco, en cualquier moneda, por su importe convertido"
									},
									"currency": {
										"type": "string",
										"description": "Moneda del banco (Formato ISO 4217)"
									},
									"currencyBalance": {
										"type": "number",
										"description": "Saldo en la moneda del banco. Suma solo los apuntes en esa moneda, por su importe en divisa"
									},
									"latestEntryDate": {
										"type": "string",
										"format": "date",
										"nullable": true,
										"description": "Fecha del último apunte que mueve el saldo (dentro del corte, si se ha pasado `balanceDate`). Null si no hay apuntes"
									},
									"date": {
										"type": "string",
										"format": "date",
										"description": "Fecha de corte del saldo. Solo si se ha pasado `balanceDate`"
									}
								}
							},
							"linkedBalance": {
								"type": "object",
								"title": "BankLinkedBalance",
								"nullable": true,
								"description": "Saldo según la entidad: el que informó el banco en el último movimiento sincronizado o importado con fecha hasta hoy. Positivo es dinero en el banco.\n\nEs un dato informativo que depende de hasta dónde ha sincronizado el proveedor: cambia con cada sincronización (cada 12 horas, o cuando el usuario la pide) y puede ir por detrás del banco. Para contabilidad usa `balance`. Lleva la fecha y el identificador del movimiento del que sale (`GET /{companyId}/statements/{id}`) y la fecha de la última sincronización correcta, para que la integración decida si le sirve.\n\nEs null cuando no hay saldo de la entidad: banco sin movimientos, movimientos importados sin saldo, o banco de Stripe (sus movimientos no traen saldo).",
								"required": [
									"balance",
									"bookedBalance",
									"currency",
									"date",
									"statement",
									"syncedAt"
								],
								"properties": {
									"balance": {
										"type": "number",
										"description": "Saldo disponible que informó la entidad tras el movimiento"
									},
									"bookedBalance": {
										"type": "number",
										"nullable": true,
										"description": "Saldo contable que informó la entidad, cuando difiere del disponible. Null si la entidad no lo informa"
									},
									"currency": {
										"type": "string",
										"description": "Moneda del saldo (Formato ISO 4217)"
									},
									"date": {
										"type": "string",
										"format": "date",
										"description": "Fecha del movimiento del que sale el saldo"
									},
									"statement": {
										"type": "string",
										"description": "Identificador del movimiento del que sale el saldo"
									},
									"syncedAt": {
										"type": "string",
										"format": "date-time",
										"nullable": true,
										"description": "Fecha y hora de la última sincronización correcta con el proveedor. Null si el banco no sincroniza (movimientos importados por fichero)"
									}
								}
							},
							"link": {
								"type": "object",
								"title": "BankLink",
								"description": "Estado de la conexión automática del banco. Nunca incluye credenciales ni referencias de cuenta del proveedor.\n\nUn banco de Stripe es `linked` en cuanto tiene la cuenta conectada, aunque no sincronice movimientos: `syncEnabled` dice si lo hace.",
								"required": [
									"status",
									"bankName",
									"accessValidUntil",
									"syncEnabled",
									"actionRequired",
									"message",
									"lastSyncAt",
									"lastSyncOk"
								],
								"properties": {
									"status": {
										"type": "string",
										"enum": [
											"manual",
											"linked",
											"paused",
											"unlinked"
										],
										"description": "Estado del enlace:\n* manual: Banco sin enlace. Sus movimientos se importan a mano\n* linked: Conectado con el banco (o cuenta de Stripe conectada)\n* paused: Conectado, pero la sincronización está pausada porque el plan no incluye más cuentas bancarias conectadas\n* unlinked: Estuvo conectado y ya no lo está"
									},
									"bankName": {
										"type": "string",
										"nullable": true,
										"description": "Nombre de la entidad según la conexión. Null en un banco manual"
									},
									"accessValidUntil": {
										"type": "string",
										"format": "date",
										"nullable": true,
										"description": "Fecha hasta la que el usuario autorizó el acceso a los datos del banco (PSD2). Null si el proveedor no la informa"
									},
									"syncEnabled": {
										"type": "boolean",
										"description": "Si el enlace sincroniza movimientos automáticamente. Es false con la sincronización pausada por el plan, con una acción pendiente del usuario, o en un banco de Stripe sin la sincronización de movimientos activada"
									},
									"actionRequired": {
										"type": "boolean",
										"description": "Si la sincronización automática está detenida porque el usuario debe hacer algo en la aplicación (volver a autorizar el acceso, confirmar un código…)"
									},
									"message": {
										"type": "string",
										"nullable": true,
										"description": "Motivo por el que la sincronización está detenida, tal como lo ve el usuario en la aplicación. Null si no lo está"
									},
									"lastSyncAt": {
										"type": "string",
										"format": "date-time",
										"nullable": true,
										"description": "Fecha y hora del último intento de sincronización. Null si nunca ha sincronizado"
									},
									"lastSyncOk": {
										"type": "boolean",
										"nullable": true,
										"description": "Si el último intento de sincronización acabó bien. Null si nunca ha sincronizado"
									}
								}
							},
							"statements": {
								"type": "object",
								"title": "BankStatements",
								"description": "Movimientos bancarios del banco. Solo contadores y fechas: el listado está en `GET /{companyId}/statements?bank={id}`",
								"required": [
									"pending",
									"latestDate"
								],
								"properties": {
									"pending": {
										"type": "integer",
										"description": "Movimientos pendientes de conciliar. Quedan fuera los ignorados y los borrados; un movimiento cuyo asiento se ha borrado vuelve a contar como pendiente"
									},
									"latestDate": {
										"type": "string",
										"format": "date",
										"nullable": true,
										"description": "Fecha del último movimiento del banco con fecha hasta hoy. Null si no tiene movimientos"
									}
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"Bill": {
				"type": "object",
				"title": "Bill",
				"required": [
					"type",
					"main",
					"uuid"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"bill"
						]
					},
					"accounting": {
						"$ref": "#/components/schemas/Accounting"
					},
					"books": {
						"$ref": "#/components/schemas/Books"
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"main": {
						"type": "object",
						"title": "BillMain",
						"required": [
							"date",
							"account",
							"dueDate",
							"total",
							"contact",
							"currency",
							"fiscalPosition",
							"lines",
							"taxes"
						],
						"additionalProperties": false,
						"properties": {
							"subtype": {
								"type": "string",
								"enum": [
									"ticket"
								]
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes de la factura de compra o ticket (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"transactionDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"depreciable": {
								"type": "boolean"
							},
							"depreciationSettings": {
								"$ref": "#/components/schemas/DepreciationSettings"
							},
							"nonDeductibleInIRPF": {
								"type": "boolean"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha de la factura (`transactionDate`, o `date` si no se indica) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni esa fecha"
							},
							"lines": {
								"type": "array",
								"title": "BillLines",
								"items": {
									"$ref": "#/components/schemas/BillMainLine"
								}
							},
							"manualAccounting": {
								"$ref": "#/components/schemas/BillMainManualAccounting"
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"linesTotal": {
								"type": "number"
							},
							"mode": {
								"type": "string",
								"enum": [
									"totalProvided",
									"calcTotal"
								]
							},
							"notes": {
								"type": "string"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"referenceNumber": {
								"type": "string"
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"taxes": {
								"$ref": "#/components/schemas/PurchasesDocumentTaxes"
							},
							"total": {
								"type": "number"
							},
							"pendingBeforeAccounting": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number"
							},
							"totalBeforeTaxes": {
								"type": "number"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (proveedor) (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"description": "Código postal de la dirección fiscal del contacto (proveedor)",
								"nullable": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"title": {
								"type": "string"
							},
							"correctedBill": {
								"type": "string"
							},
							"manualTotals": {
								"type": "boolean"
							},
							"task": {
								"type": "string"
							},
							"installments": {
								"$ref": "#/components/schemas/Installments"
							},
							"draft": {
								"type": "boolean",
								"description": "Indica si la factura es provisional (true) o definitiva (false). Cuando creamos una factura si no se indica la factura se creará como provisional o definitiva según la configuración de la empresa."
							},
							"voided": {
								"type": "boolean",
								"description": "Indica si es una factura anulada.\n\nNOTA: Solo pueden anularse facturas en empresas que soportan el registro de facturas de compra en sistemas externos, en otro caso debe usarse la opción de borrado."
							},
							"ticketbai": {
								"$ref": "#/components/schemas/BillMainTicketbai"
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							}
						}
					},
					"meta": {
						"type": "object",
						"title": "BillMeta",
						"description": "Metadatos internos de la factura",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							},
							"ticketbai": {
								"$ref": "#/components/schemas/BillMetaTicketbai"
							}
						},
						"readOnly": true
					}
				}
			},
			"DepreciationSettings": {
				"type": "object",
				"title": "BillDepreciationSettings",
				"additionalProperties": false,
				"properties": {
					"maxRate": {
						"type": "number",
						"minimum": 0
					},
					"startDepreciationDate": {
						"type": "string",
						"format": "date"
					},
					"earlyDisposalDate": {
						"type": "string",
						"format": "date"
					},
					"accumulatedDepreciationAccount": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"provisioningDepreciationAccount": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"amountToDepreciate": {
						"type": "number"
					},
					"currencyAmountToDepreciate": {
						"type": "number"
					},
					"depreciations": {
						"type": "array",
						"title": "Depreciations",
						"minItems": 1,
						"items": {
							"$ref": "#/components/schemas/DepreciationEntry"
						}
					}
				},
				"required": [
					"maxRate"
				]
			},
			"DepreciationEntry": {
				"type": "object",
				"title": "BillDepreciationSettingsEntry",
				"additionalProperties": false,
				"properties": {
					"date": {
						"type": "string",
						"format": "date"
					},
					"amount": {
						"type": "number"
					},
					"currencyAmount": {
						"type": "number"
					},
					"currency": {
						"type": "string"
					}
				},
				"required": [
					"date",
					"amount",
					"currencyAmount",
					"currency"
				]
			},
			"BillMainLine": {
				"type": "object",
				"title": "BillMainLine",
				"additionalProperties": false,
				"required": [
					"account",
					"text",
					"lineTotal",
					"tax"
				],
				"properties": {
					"origin": {
						"type": "string",
						"description": "Indica aquí el ID del documento de origen de esta línea si proviene de otro documento para que los documentos queden enlazados",
						"nullable": true
					},
					"id": {
						"type": "string"
					},
					"text": {
						"type": "string"
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"lineTotal": {
						"type": "number"
					},
					"nonDeductibleTax": {
						"type": "boolean",
						"enum": [
							true
						]
					},
					"tax": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de compras de la empresa con `GET /{companyId}/settings/taxes/purchases`. Pueden coincidir varios impuestos en una misma línea, típicamente IVA + retención de IRPF. Los impuestos autorepercutidos (intracomunitarios, inversión del sujeto pasivo, importación de servicios) no se envían aquí: el sistema los genera automáticamente a partir de su impuesto base.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.purchases.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, importación, recargo de equivalencia, IRPF de servicios profesionales, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.purchases`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"unitPrice": {
						"type": "number"
					}
				}
			},
			"BillMainLineWrite": {
				"type": "object",
				"title": "BillMainLineWrite",
				"additionalProperties": false,
				"required": [
					"text"
				],
				"properties": {
					"origin": {
						"type": "string",
						"description": "Indica aquí el ID del documento de origen de esta línea si proviene de otro documento para que los documentos queden enlazados",
						"nullable": true
					},
					"id": {
						"type": "string"
					},
					"text": {
						"type": "string"
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"lineTotal": {
						"type": "number"
					},
					"nonDeductibleTax": {
						"type": "boolean",
						"enum": [
							true
						]
					},
					"tax": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de compras de la empresa con `GET /{companyId}/settings/taxes/purchases`. Pueden coincidir varios impuestos en una misma línea, típicamente IVA + retención de IRPF. Los impuestos autorepercutidos (intracomunitarios, inversión del sujeto pasivo, importación de servicios) no se envían aquí: el sistema los genera automáticamente a partir de su impuesto base.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.purchases.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, importación, recargo de equivalencia, IRPF de servicios profesionales, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.purchases`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"unitPrice": {
						"type": "number"
					}
				},
				"description": "Versión de la línea de factura de compra para creación del documento"
			},
			"BillMainManualAccounting": {
				"type": "object",
				"title": "BillMainManualAccounting",
				"description": "Contabilidad manual de la factura.\n\nEn este elemento pueden indicarse las líneas que se genearán en la contabilidad para esta factura a excepción de las del total del documento y las de impuestos que son generadas automáticamente por el programa",
				"additionalProperties": false,
				"properties": {
					"lines": {
						"type": "array",
						"title": "BillMainManualAccountingLines",
						"minItems": 1,
						"items": {
							"$ref": "#/components/schemas/AccountingLine"
						}
					}
				},
				"required": [
					"lines"
				]
			},
			"BillMainTicketbai": {
				"type": "object",
				"title": "BillMainTicketbai",
				"description": "Parámetros de ajustes para TicketBAI",
				"additionalProperties": false,
				"properties": {
					"batuzRentaGastos": {
						"type": "array",
						"minItems": 1,
						"maxItems": 1,
						"items": {
							"type": "object",
							"additionalProperties": false,
							"properties": {
								"epigrafe": {
									"type": "string",
									"minLength": 1,
									"maxLength": 7
								},
								"concepto": {
									"type": "string",
									"minLength": 2,
									"maxLength": 5,
									"enum": [
										"600",
										"601",
										"602",
										"606",
										"607",
										"608",
										"609",
										"620",
										"621",
										"622",
										"623",
										"624",
										"625",
										"626",
										"627",
										"628",
										"629",
										"631",
										"634",
										"639",
										"640",
										"641",
										"64201",
										"64202",
										"643",
										"644",
										"649",
										"65",
										"66",
										"67",
										"680",
										"681",
										"682",
										"69"
									]
								},
								"referenciaBien": {
									"type": "string",
									"minLength": 1,
									"maxLength": 10
								}
							}
						}
					},
					"batuzClaveTipoFacturaGastos": {
						"type": "string",
						"minLength": 2,
						"maxLength": 2,
						"enum": [
							"F1",
							"F2",
							"F3",
							"F4",
							"F5",
							"F6",
							"LC"
						]
					},
					"batuzClavesRegimenIvaOpTrascendencia": {
						"type": "array",
						"minItems": 1,
						"maxItems": 3,
						"items": {
							"type": "string",
							"enum": [
								"01",
								"02",
								"03",
								"04",
								"05",
								"07",
								"08",
								"09",
								"12",
								"13"
							]
						}
					},
					"batuzClaveTipoFacturaRectificativa": {
						"type": "string",
						"enum": [
							"R1",
							"R2",
							"R3",
							"R4",
							"R5"
						]
					},
					"batuzSerieFacturaRectificativa": {
						"type": "string"
					},
					"batuzIDFacturaRectificadaSustituida": {
						"type": "array",
						"minItems": 1,
						"maxItems": 1,
						"items": {
							"type": "object",
							"additionalProperties": false,
							"required": [
								"NumFactura",
								"FechaExpedicionFactura"
							],
							"properties": {
								"SerieFactura": {
									"type": "string",
									"minLength": 1,
									"maxLength": 20
								},
								"NumFactura": {
									"type": "string",
									"minLength": 1,
									"maxLength": 20
								},
								"FechaExpedicionFactura": {
									"type": "string",
									"minLength": 10,
									"maxLength": 10,
									"pattern": "^(0[1-9]|[12][0-9]|3[01])-(0[1-9]|1[012])-(19|20)\\d\\d$"
								}
							}
						}
					}
				}
			},
			"BillMetaTicketbai": {
				"type": "object",
				"title": "BillMetaTicketbai",
				"description": "Información interna relativa a TicketBAI",
				"required": [
					"mustBeSent",
					"sent",
					"batuzModel"
				],
				"properties": {
					"mustBeSent": {
						"type": "boolean",
						"deprecated": true,
						"description": "Deprecated: campo inerte. El estado de envío de TicketBAI vive en fiscal_records; se conserva por compatibilidad y siempre vale false."
					},
					"sent": {
						"type": "boolean"
					},
					"batuzModel": {
						"type": "object",
						"title": "XmlBatuzModelAlta",
						"description": "Modelo interno del contenido del XML de alta en Batuz (Aplica en Bizkaia)",
						"additionalProperties": true
					},
					"voided": {
						"type": "object",
						"title": "VoidedBill",
						"description": "Información de TicketBAI relativa a la anulación de la factura",
						"additionalProperties": false,
						"required": [
							"mustBeSent",
							"sent",
							"batuzModel"
						],
						"properties": {
							"mustBeSent": {
								"type": "boolean",
								"deprecated": true,
								"description": "Deprecated: campo inerte. El estado de envío de TicketBAI vive en fiscal_records; se conserva por compatibilidad y siempre vale false."
							},
							"sent": {
								"type": "boolean"
							},
							"batuzModel": {
								"type": "object",
								"title": "XmlBatuzModelAnulacion",
								"description": "Modelo interno del contenido del XML de anulación en Batuz (Aplica en Bizkaia)",
								"additionalProperties": true
							}
						}
					}
				}
			},
			"BillPaymentsWrite": {
				"type": "array",
				"title": "BillPaymentsWrite",
				"description": "Permite crear un pago para una factura de compra o ticket.\n\nSe pueden crear múltiples pagos e indicar el importe individual para cada uno de ellos.\n\nSi no se indica el importe (amount) se considera que con ese pago se quiere saldar todo el importe pendiente de la factura de compra o ticket, dentro del array solo puede haber un pago sin importe y debe estar en la última posición del array",
				"items": {
					"type": "object",
					"title": "BillPaymentWrite",
					"description": "Nuevo pago de una factura de compra o ticket.",
					"required": [
						"bank"
					],
					"properties": {
						"date": {
							"type": "string",
							"format": "date",
							"description": "Fecha en la que contabilizar el pago, si no se indica se usa la fecha actual"
						},
						"bank": {
							"type": "string",
							"description": "ID del banco en el que se anota el pago"
						},
						"amount": {
							"type": "number",
							"description": "Importe del pago en la moneda original de la factura de compra o ticket. Si no se indica se saldará todo el importe pendiente"
						},
						"companyCurrencyAmount": {
							"type": "number",
							"description": "Importe a contabilizar en euros, puede indicarse solo cuando la moneda de la factura de compra o ticket sea distinta a euros y se quiera indicar el valor exacto a contabilizar de dicho pago en euros. Si no se indica se aplicará un tipo de cambio de forma automática según la fecha del pago"
						},
						"description": {
							"type": "string",
							"description": "Descripción del pago. Sustituye al título por defecto (\"Pago <factura de compra>\"). Visible en la columna \"Descripción\" de Bancos → Movimientos. Útil para almacenar una referencia operativa del pago real (p. ej. referencia de transferencia)."
						},
						"notes": {
							"type": "string",
							"description": "Notas asociadas al pago. Texto libre adicional consultable desde Bancos → Movimientos. Útil cuando se quiere mantener la descripción auto-generada y registrar aparte una referencia operativa."
						}
					}
				}
			},
			"BillPaymentsWriteResponse": {
				"type": "object",
				"title": "BillPaymentsWriteResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/Bill"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "BillRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "BillRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/TaxDefinition"
											}
										]
									}
								}
							},
							"balance": {
								"type": "object",
								"title": "BillBalance",
								"description": "Saldo abierto de la factura de compra o ticket.\n\nSe devuelve el saldo contable de la factura de compra o ticket, por lo que el importe pendiente de pagar se muestra como un valor positivo. El importe se indica en la moneda de la factura en el elemento `currencyBalance` y en la moneda de la contabilidad de la empresa en el elemento `balance`\n\n```\n{\n  \"balance\": {\n    \"balance\": 28.56,\n    \"currency\": \"USD\",\n    \"currencyBalance\": 30.52\n  }\n}\n```\n\nEl ejemplo anterior corresponde a una factura de compra contabilizada en USD que tiene un importe pendiente de 30,52 USD que están contabilizados como 28,56 EUR.\n\nEn general para saber el importe pendiente de pagar de una factura de compra debe utilizarse por tanto el elemento `currencyBalance` que es el que representa el saldo pendiente en la moneda en la que se ha registrado la factura de compra o ticket.\n",
								"required": [
									"balance",
									"currency",
									"currencyBalance"
								],
								"properties": {
									"balance": {
										"type": "number",
										"description": "Saldo pendiente de la factura de compra o ticket en EUR"
									},
									"currency": {
										"type": "string",
										"description": "Moneda original del saldo pendiente de la factura de compra o ticket (Formato ISO 4217)"
									},
									"currencyBalance": {
										"type": "number",
										"description": "Saldo pendiente de la factura de compra o ticket en la moneda de la factura"
									}
								}
							},
							"state": {
								"type": "string",
								"enum": [
									"draft",
									"pending",
									"overdue",
									"paid",
									"overpaid",
									"voided"
								],
								"description": "Estado de la factura de compra o ticket.\n\n* draft: Borrador\n* pending: Pendiente de pago (Factura de compra con saldo pendiente que aún no ha alcanzado las fechas de vencimiento previstas)\n* overdue: Vencida (El saldo pendiente actual es superior al esperado según la información de vencimientos)\n* paid: Pagada (Factura de compra con saldo pendiente cero)\n* overpaid: Sobrepagada (Tiene pagos por encima del importe esperado)\n* voided: Anulada"
							},
							"journal": {
								"type": "array",
								"description": "Apuntes contables de `/journal` que afectan al saldo de la factura de compra o ticket.\n\nSe devuelve una entrada por cada documento de saldo (cobros, pagos o remesas SEPA), con la misma forma reducida del endpoint `GET /{companyId}/journal?document={id}` pero sin los campos redundantes con el documento padre (`document`, `documentType`, `documentTitle`) ni los opt-in del endpoint `/journal` (`idAccounting`, `tags`).\n\nLos IDs son polimórficos:\n\n* **`tra_<uuid-v4>`** — `transaction` (asiento contable directo). Caso típico cuando el cobro/pago se ha registrado manualmente o vía transferencia convencional anotada en un banco.\n* **`pay_<uuid-v4>`** — `payment` (remesa SEPA). Aparece cuando la operación se ha agrupado en una remesa de adeudos directos o transferencias SEPA.\n\nLa lista incluye **todos** los apuntes que actualmente componen el saldo (no sólo los recién creados en una llamada). El orden es el mismo que devolvería `GET /journal?document={id}`: por fecha, prioridad contable y línea.\n\nLos campos `currency`, `currencyDebit` y `currencyCredit` sólo aparecen si la empresa tiene multicurrency activada y el apunte está en una moneda distinta a la de la contabilidad.",
								"items": {
									"$ref": "#/components/schemas/RelatedJournalEntry"
								}
							}
						}
					},
					"paymentsInfo": {
						"type": "object",
						"properties": {
							"total": {
								"type": "number",
								"description": "Número total de pagos que modifican el saldo de la factura de compra o ticket"
							},
							"totalCreated": {
								"type": "number",
								"description": "Número total de pagos creados en esta operación"
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"BillResponse": {
				"type": "object",
				"title": "BillResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/Bill"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "BillRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "BillRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/TaxDefinition"
											}
										]
									}
								}
							},
							"balance": {
								"type": "object",
								"title": "BillBalance",
								"description": "Saldo abierto de la factura de compra o ticket.\n\nSe devuelve el saldo contable de la factura de compra o ticket, por lo que el importe pendiente de pagar se muestra como un valor positivo. El importe se indica en la moneda de la factura en el elemento `currencyBalance` y en la moneda de la contabilidad de la empresa en el elemento `balance`\n\n```\n{\n  \"balance\": {\n    \"balance\": 28.56,\n    \"currency\": \"USD\",\n    \"currencyBalance\": 30.52\n  }\n}\n```\n\nEl ejemplo anterior corresponde a una factura de compra contabilizada en USD que tiene un importe pendiente de 30,52 USD que están contabilizados como 28,56 EUR.\n\nEn general para saber el importe pendiente de pagar de una factura de compra debe utilizarse por tanto el elemento `currencyBalance` que es el que representa el saldo pendiente en la moneda en la que se ha registrado la factura de compra o ticket.\n",
								"required": [
									"balance",
									"currency",
									"currencyBalance"
								],
								"properties": {
									"balance": {
										"type": "number",
										"description": "Saldo pendiente de la factura de compra o ticket en EUR"
									},
									"currency": {
										"type": "string",
										"description": "Moneda original del saldo pendiente de la factura de compra o ticket (Formato ISO 4217)"
									},
									"currencyBalance": {
										"type": "number",
										"description": "Saldo pendiente de la factura de compra o ticket en la moneda de la factura"
									}
								}
							},
							"state": {
								"type": "string",
								"enum": [
									"draft",
									"pending",
									"overdue",
									"paid",
									"overpaid",
									"voided"
								],
								"description": "Estado de la factura de compra o ticket.\n\n* draft: Borrador\n* pending: Pendiente de pago (Factura de compra con saldo pendiente que aún no ha alcanzado las fechas de vencimiento previstas)\n* overdue: Vencida (El saldo pendiente actual es superior al esperado según la información de vencimientos)\n* paid: Pagada (Factura de compra con saldo pendiente cero)\n* overpaid: Sobrepagada (Tiene pagos por encima del importe esperado)\n* voided: Anulada"
							},
							"journal": {
								"type": "array",
								"description": "Apuntes contables de `/journal` que afectan al saldo de la factura de compra o ticket.\n\nSe devuelve una entrada por cada documento de saldo (cobros, pagos o remesas SEPA), con la misma forma reducida del endpoint `GET /{companyId}/journal?document={id}` pero sin los campos redundantes con el documento padre (`document`, `documentType`, `documentTitle`) ni los opt-in del endpoint `/journal` (`idAccounting`, `tags`).\n\nLos IDs son polimórficos:\n\n* **`tra_<uuid-v4>`** — `transaction` (asiento contable directo). Caso típico cuando el cobro/pago se ha registrado manualmente o vía transferencia convencional anotada en un banco.\n* **`pay_<uuid-v4>`** — `payment` (remesa SEPA). Aparece cuando la operación se ha agrupado en una remesa de adeudos directos o transferencias SEPA.\n\nLa lista incluye **todos** los apuntes que actualmente componen el saldo (no sólo los recién creados en una llamada). El orden es el mismo que devolvería `GET /journal?document={id}`: por fecha, prioridad contable y línea.\n\nLos campos `currency`, `currencyDebit` y `currencyCredit` sólo aparecen si la empresa tiene multicurrency activada y el apunte está en una moneda distinta a la de la contabilidad.",
								"items": {
									"$ref": "#/components/schemas/RelatedJournalEntry"
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"BillWrite": {
				"type": "object",
				"title": "BillWrite",
				"required": [
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"bill"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/AttachmentWrite"
						},
						"maxItems": 10
					},
					"main": {
						"type": "object",
						"title": "BillMain",
						"required": [
							"contact",
							"currency",
							"lines"
						],
						"additionalProperties": false,
						"properties": {
							"subtype": {
								"type": "string",
								"enum": [
									"ticket"
								]
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes de la factura de compra o ticket (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"transactionDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"depreciable": {
								"type": "boolean"
							},
							"depreciationSettings": {
								"$ref": "#/components/schemas/DepreciationSettings"
							},
							"nonDeductibleInIRPF": {
								"type": "boolean"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha de la factura (`transactionDate`, o `date` si no se indica) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni esa fecha"
							},
							"lines": {
								"type": "array",
								"title": "BillLines",
								"items": {
									"$ref": "#/components/schemas/BillMainLineWrite"
								}
							},
							"manualAccounting": {
								"$ref": "#/components/schemas/BillMainManualAccounting"
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"linesTotal": {
								"type": "number"
							},
							"mode": {
								"type": "string",
								"enum": [
									"totalProvided",
									"calcTotal"
								]
							},
							"notes": {
								"type": "string"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"referenceNumber": {
								"type": "string"
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"taxes": {
								"$ref": "#/components/schemas/PurchasesDocumentTaxes"
							},
							"total": {
								"type": "number"
							},
							"pendingBeforeAccounting": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number"
							},
							"totalBeforeTaxes": {
								"type": "number"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (proveedor) (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"description": "Código postal de la dirección fiscal del contacto (proveedor)",
								"nullable": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"title": {
								"type": "string"
							},
							"correctedBill": {
								"type": "string"
							},
							"manualTotals": {
								"type": "boolean"
							},
							"task": {
								"type": "string"
							},
							"installments": {
								"$ref": "#/components/schemas/Installments"
							},
							"draft": {
								"type": "boolean",
								"description": "Indica si la factura es provisional (true) o definitiva (false). Cuando creamos una factura si no se indica la factura se creará como provisional o definitiva según la configuración de la empresa."
							},
							"voided": {
								"type": "boolean",
								"description": "Indica si es una factura anulada.\n\nNOTA: Solo pueden anularse facturas en empresas que soportan el registro de facturas de compra en sistemas externos, en otro caso debe usarse la opción de borrado."
							},
							"ticketbai": {
								"$ref": "#/components/schemas/BillMainTicketbai"
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							}
						}
					},
					"meta": {
						"type": "object",
						"title": "BillMeta",
						"description": "Metadatos internos de la factura",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							},
							"ticketbai": {
								"$ref": "#/components/schemas/BillMetaTicketbai"
							}
						},
						"readOnly": true
					}
				},
				"description": "Versión simplificada de la factura de compra o ticket sin los elementos que calcula automáticamente FacturaDirecta"
			},
			"ClientOrder": {
				"type": "object",
				"title": "ClientOrder",
				"required": [
					"uuid",
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"clientOrder"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"main": {
						"type": "object",
						"title": "ClientOrderMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"state": {
								"type": "string",
								"enum": [
									"pending",
									"ready",
									"delivered",
									"canceled"
								],
								"description": "Estado del pedido. Se calcula automáticamente a partir del estado de sus líneas (`lines[].state`) con esta prioridad: si alguna línea está `pending` u `ordered` el pedido está `pending`; si no, si alguna está `ready` el pedido está `ready`; si no, si alguna está `delivered` el pedido está `delivered`; si todas están `canceled` el pedido está `canceled`. Para cambiar el estado del pedido se cambian los estados de sus líneas."
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes del pedido (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumber"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"emails": {
								"type": "string"
							},
							"emailsCc": {
								"type": "string"
							},
							"emailsBcc": {
								"type": "string"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "ClientOrderLines",
								"items": {
									"$ref": "#/components/schemas/ClientOrderMainLine"
								}
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles del pedido",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/SalesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"manualTotals": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas del pedido, no serán visibles en el documento impreso"
							},
							"taxCalculationMode": {
								"type": "string",
								"enum": [
									"total",
									"lines"
								]
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable del pedido. Se usa para limitar la visibilidad a documentos asignados."
							}
						},
						"required": [
							"account",
							"currency",
							"state",
							"date",
							"docNumber",
							"dueDate",
							"exchangeRate",
							"fiscalPosition",
							"lines",
							"lineTotalDecimals",
							"linesTotal",
							"taxes",
							"taxIncludedPrices",
							"theme",
							"total"
						]
					},
					"meta": {
						"type": "object",
						"title": "ClientOrderMeta",
						"description": "Metadatos internos del pedido",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				}
			},
			"ClientOrderMainLine": {
				"type": "object",
				"title": "ClientOrderMainLine",
				"additionalProperties": false,
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador estable de la línea dentro del pedido. Lo genera FacturaDirecta si no se indica. Al actualizar el pedido, las líneas que incluyan un `id` existente conservan su identidad (y por tanto sus vínculos con otros documentos); las líneas sin `id` se tratan como líneas nuevas."
					},
					"origin": {
						"type": "string",
						"description": "Indica aquí el ID del documento de origen de esta línea si proviene de otro documento para que los documentos queden enlazados",
						"nullable": true
					},
					"state": {
						"type": "string",
						"enum": [
							"pending",
							"ordered",
							"ready",
							"delivered",
							"canceled"
						],
						"description": "Estado de la línea del pedido: `pending` (pendiente), `ordered` (pedida a proveedor), `ready` (lista para entregar), `delivered` (entregada) o `canceled` (cancelada). El estado del pedido se calcula a partir de los estados de sus líneas. El estado `ordered` lo gestiona FacturaDirecta cuando la línea está vinculada a una orden de compra."
					},
					"provider": {
						"type": "string",
						"description": "ID del contacto proveedor que suministrará esta línea. Se usa para generar órdenes de compra a partir de líneas pendientes. Si la línea referencia un producto con proveedor asociado, se usa como valor por defecto.",
						"nullable": true
					},
					"purchaseOrder": {
						"type": "string",
						"description": "ID de la orden de compra vinculada a esta línea. Lo gestiona FacturaDirecta al generar la orden de compra.",
						"nullable": true
					},
					"purchaseOrderLine": {
						"type": "string",
						"description": "ID de la línea de la orden de compra vinculada a esta línea. Lo gestiona FacturaDirecta al generar la orden de compra.",
						"nullable": true
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "ClientOrderLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de ventas de la empresa con `GET /{companyId}/settings/taxes/sales`. Pueden coincidir varios impuestos en una misma línea, típicamente IVA + retención de IRPF para servicios profesionales.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.sales.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, exportación, OSS, recargo de equivalencia, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.sales`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					}
				},
				"required": [
					"id",
					"state",
					"account",
					"discount",
					"discountRate",
					"lineTotal",
					"quantity",
					"text",
					"unitPrice"
				]
			},
			"ClientOrderMainLineWrite": {
				"type": "object",
				"title": "ClientOrderMainLineWrite",
				"additionalProperties": false,
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador estable de la línea dentro del pedido. Lo genera FacturaDirecta si no se indica. Al actualizar el pedido, las líneas que incluyan un `id` existente conservan su identidad (y por tanto sus vínculos con otros documentos); las líneas sin `id` se tratan como líneas nuevas."
					},
					"origin": {
						"type": "string",
						"description": "Indica aquí el ID del documento de origen de esta línea si proviene de otro documento para que los documentos queden enlazados",
						"nullable": true
					},
					"state": {
						"type": "string",
						"enum": [
							"pending",
							"ordered",
							"ready",
							"delivered",
							"canceled"
						],
						"description": "Estado de la línea del pedido: `pending` (pendiente), `ordered` (pedida a proveedor), `ready` (lista para entregar), `delivered` (entregada) o `canceled` (cancelada). El estado del pedido se calcula a partir de los estados de sus líneas. El estado `ordered` lo gestiona FacturaDirecta cuando la línea está vinculada a una orden de compra."
					},
					"provider": {
						"type": "string",
						"description": "ID del contacto proveedor que suministrará esta línea. Se usa para generar órdenes de compra a partir de líneas pendientes. Si la línea referencia un producto con proveedor asociado, se usa como valor por defecto.",
						"nullable": true
					},
					"purchaseOrder": {
						"type": "string",
						"description": "ID de la orden de compra vinculada a esta línea. Lo gestiona FacturaDirecta al generar la orden de compra.",
						"nullable": true
					},
					"purchaseOrderLine": {
						"type": "string",
						"description": "ID de la línea de la orden de compra vinculada a esta línea. Lo gestiona FacturaDirecta al generar la orden de compra.",
						"nullable": true
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "ClientOrderLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de ventas de la empresa con `GET /{companyId}/settings/taxes/sales`. Pueden coincidir varios impuestos en una misma línea, típicamente IVA + retención de IRPF para servicios profesionales.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.sales.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, exportación, OSS, recargo de equivalencia, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.sales`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					}
				},
				"required": [
					"quantity",
					"text",
					"unitPrice"
				],
				"description": "Versión de la línea de pedido para creación del documento. Si no se indica `id` FacturaDirecta genera uno nuevo, y si no se indica `state` la línea se crea como `pending`"
			},
			"ClientOrderResponse": {
				"type": "object",
				"title": "ClientOrderResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/ClientOrder"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "ClientOrderRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "ClientOrderRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/TaxDefinition"
											}
										]
									}
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"ClientOrderWrite": {
				"type": "object",
				"title": "ClientOrderWrite",
				"required": [
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"clientOrder"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/AttachmentWrite"
						},
						"maxItems": 10
					},
					"main": {
						"type": "object",
						"title": "ClientOrderMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"state": {
								"type": "string",
								"enum": [
									"pending",
									"ready",
									"delivered",
									"canceled"
								],
								"description": "Estado del pedido. Se calcula automáticamente a partir del estado de sus líneas (`lines[].state`) con esta prioridad: si alguna línea está `pending` u `ordered` el pedido está `pending`; si no, si alguna está `ready` el pedido está `ready`; si no, si alguna está `delivered` el pedido está `delivered`; si todas están `canceled` el pedido está `canceled`. Para cambiar el estado del pedido se cambian los estados de sus líneas."
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes del pedido (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumberWrite"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"emails": {
								"type": "string"
							},
							"emailsCc": {
								"type": "string"
							},
							"emailsBcc": {
								"type": "string"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "ClientOrderLines",
								"items": {
									"$ref": "#/components/schemas/ClientOrderMainLineWrite"
								}
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles del pedido",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/SalesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas del pedido, no serán visibles en el documento impreso"
							},
							"taxCalculationMode": {
								"type": "string",
								"enum": [
									"total",
									"lines"
								]
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable del pedido. Se usa para limitar la visibilidad a documentos asignados."
							}
						},
						"required": [
							"docNumber",
							"lines"
						]
					},
					"meta": {
						"type": "object",
						"title": "ClientOrderMeta",
						"description": "Metadatos internos del pedido",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				},
				"description": "Versión simplificada del pedido con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"CompanySettings": {
				"type": "object",
				"title": "CompanySettings",
				"description": "Ficha de la empresa y su forma de trabajar: lo que una integración o un agente necesita saber antes de crear documentos o enviar ficheros a la bandeja. Solo lectura: la configuración se cambia desde la interfaz (ver `webUrl`).",
				"required": [
					"company",
					"locale",
					"sales",
					"expenses",
					"taxes",
					"numbering",
					"accounting",
					"fiscal",
					"email",
					"clientPortal",
					"inbox",
					"modules"
				],
				"additionalProperties": false,
				"properties": {
					"company": {
						"type": "object",
						"title": "CompanySettingsCompany",
						"description": "Datos identificativos y fiscales de la empresa",
						"required": [
							"id",
							"sandbox",
							"name",
							"surname",
							"brand",
							"taxCode",
							"email",
							"phone",
							"website",
							"address",
							"country",
							"businessType",
							"taxRegion",
							"currency",
							"creationDate"
						],
						"additionalProperties": false,
						"properties": {
							"id": {
								"type": "string",
								"description": "Identificador de la empresa (`com_…`), el `companyId` de las rutas"
							},
							"sandbox": {
								"type": "boolean",
								"description": "`true` si es un entorno de pruebas (sandbox): sus documentos no tienen validez y no se envían a la AEAT ni a las diputaciones"
							},
							"name": {
								"type": "string",
								"description": "Nombre o razón social"
							},
							"surname": {
								"type": "string",
								"nullable": true,
								"description": "Primer apellido, si la empresa es una persona física"
							},
							"brand": {
								"type": "string",
								"nullable": true,
								"description": "Marca comercial"
							},
							"taxCode": {
								"type": "string",
								"description": "NIF/CIF"
							},
							"email": {
								"type": "string",
								"nullable": true,
								"description": "Correo de contacto de la empresa"
							},
							"phone": {
								"type": "string",
								"nullable": true,
								"description": "Teléfono"
							},
							"website": {
								"type": "string",
								"nullable": true,
								"description": "Sitio web"
							},
							"address": {
								"type": "object",
								"title": "CompanySettingsAddress",
								"description": "Dirección fiscal",
								"required": [
									"details",
									"zipcode",
									"city",
									"province",
									"country"
								],
								"additionalProperties": false,
								"properties": {
									"details": {
										"type": "string",
										"description": "Calle y número"
									},
									"zipcode": {
										"type": "string"
									},
									"city": {
										"type": "string"
									},
									"province": {
										"type": "string"
									},
									"country": {
										"type": "string",
										"description": "País (ISO 3166-1 alpha-2)"
									}
								}
							},
							"country": {
								"type": "string",
								"description": "País fiscal de la empresa (ISO 3166-1 alpha-2)"
							},
							"businessType": {
								"type": "string",
								"enum": [
									"EM",
									"AU",
									"AS"
								],
								"description": "Forma jurídica: `EM` empresa, `AU` autónomo, `AS` asociación o entidad sin ánimo de lucro"
							},
							"taxRegion": {
								"type": "string",
								"enum": [
									"ES_ES",
									"ES_Canarias",
									"ES_PaisVasco",
									"ES_Navarra",
									"ES_Melilla",
									"ES_Ceuta",
									"INTL"
								],
								"description": "Región fiscal, que decide los impuestos disponibles (ver `/settings/taxes/*`): IVA en `ES_ES`, `ES_PaisVasco` y `ES_Navarra`; IGIC en `ES_Canarias`; IPSI en `ES_Ceuta` y `ES_Melilla`; `INTL` fuera de España"
							},
							"currency": {
								"type": "string",
								"description": "Moneda principal (ISO 4217). Los documentos en otra moneda requieren `modules.multicurrency`"
							},
							"creationDate": {
								"type": "string",
								"format": "date-time",
								"description": "Fecha de alta de la empresa en FacturaDirecta"
							}
						}
					},
					"locale": {
						"type": "object",
						"title": "CompanySettingsLocale",
						"description": "Idioma, zona horaria y formatos con los que la empresa ve fechas y horas. La API siempre intercambia fechas en ISO 8601; estos formatos describen la interfaz y los PDF",
						"required": [
							"timezone",
							"language",
							"dateFormat",
							"timeFormat",
							"dateTimeFormat"
						],
						"additionalProperties": false,
						"properties": {
							"timezone": {
								"type": "string",
								"description": "Zona horaria IANA (p. ej. `Europe/Madrid`)"
							},
							"language": {
								"type": "string",
								"description": "Idioma de la interfaz y de los documentos por defecto (`es`, `ca`, `en`…)"
							},
							"dateFormat": {
								"type": "string",
								"description": "Formato de fecha en la interfaz y los PDF (sintaxis moment, p. ej. `DD-MM-YYYY`)"
							},
							"timeFormat": {
								"type": "string"
							},
							"dateTimeFormat": {
								"type": "string"
							}
						}
					},
					"sales": {
						"type": "object",
						"title": "CompanySettingsSales",
						"description": "Cómo trabaja la empresa con los documentos de venta",
						"required": [
							"newInvoiceMode",
							"taxCalculationMode",
							"externalInvoicesEnabled"
						],
						"additionalProperties": false,
						"properties": {
							"newInvoiceMode": {
								"type": "string",
								"enum": [
									"final",
									"draft"
								],
								"description": "Estado con el que nacen las facturas nuevas cuando no se indica `content.main.draft`: `draft` las deja provisionales (sin número definitivo) y `final` las emite al guardar"
							},
							"taxCalculationMode": {
								"type": "string",
								"enum": [
									"total",
									"lines"
								],
								"description": "Cálculo de los impuestos por defecto: sobre el total de cada base (`total`) o línea a línea (`lines`). TicketBAI exige `lines` en algunas diputaciones"
							},
							"externalInvoicesEnabled": {
								"type": "boolean",
								"description": "Si la empresa registra facturas emitidas fuera de FacturaDirecta (series de tipo `external`)"
							}
						}
					},
					"expenses": {
						"type": "object",
						"title": "CompanySettingsExpenses",
						"description": "Cómo trabaja la empresa con los gastos",
						"required": [
							"newBillMode",
							"taskToExpenseDefaultDate"
						],
						"additionalProperties": false,
						"properties": {
							"newBillMode": {
								"type": "string",
								"enum": [
									"final",
									"draft"
								],
								"description": "Estado con el que nacen las facturas de compra y tickets nuevos cuando no se indica `content.main.draft`"
							},
							"taskToExpenseDefaultDate": {
								"type": "string",
								"enum": [
									"invoiceDateOrEmpty",
									"today"
								],
								"description": "Fecha que propone la interfaz al convertir un documento de la bandeja en gasto: la fecha de la factura escaneada (o ninguna) o la de hoy"
							}
						}
					},
					"taxes": {
						"type": "object",
						"title": "CompanySettingsTaxes",
						"description": "Régimen fiscal de la empresa. El catálogo de impuestos está en `/settings/taxes/sales` y `/settings/taxes/purchases`",
						"required": [
							"defaultSales",
							"equivalenceSurcharge",
							"applyVatEUToFinalConsumer",
							"vatEU"
						],
						"additionalProperties": false,
						"properties": {
							"defaultSales": {
								"type": "string",
								"enum": [
									"BC",
									"SV"
								],
								"description": "Naturaleza por defecto de lo que vende: bienes (`BC`) o servicios (`SV`). Decide el impuesto propuesto en operaciones intracomunitarias y con el extranjero"
							},
							"equivalenceSurcharge": {
								"type": "boolean",
								"description": "La empresa está en el régimen especial de recargo de equivalencia (comercio minorista)"
							},
							"applyVatEUToFinalConsumer": {
								"type": "boolean",
								"description": "Aplica el IVA del país de destino a los consumidores finales de la UE (régimen OSS)"
							},
							"vatEU": {
								"type": "string",
								"nullable": true,
								"description": "NIF-IVA intracomunitario (ROI) si la empresa lo tiene registrado; `null` si no opera como operador intracomunitario"
							}
						}
					},
					"numbering": {
						"type": "object",
						"title": "CompanySettingsNumbering",
						"description": "Formato de los números de documento. Las series están en `/settings/series/{documentType}`",
						"required": [
							"zeros",
							"position"
						],
						"additionalProperties": false,
						"properties": {
							"zeros": {
								"type": "integer",
								"description": "Dígitos mínimos del número, rellenado con ceros a la izquierda (`4` produce `F-0001`)"
							},
							"position": {
								"type": "string",
								"enum": [
									"prefix",
									"suffix"
								],
								"description": "Si la serie va delante del número (`prefix`, `F-0001`) o detrás (`suffix`, `0001-F`)"
							}
						}
					},
					"accounting": {
						"type": "object",
						"title": "CompanySettingsAccounting",
						"description": "Fechas que limitan la contabilidad. Los informes contables requieren `modules.accounting`",
						"required": [
							"startDate",
							"lockDate"
						],
						"additionalProperties": false,
						"properties": {
							"startDate": {
								"type": "string",
								"nullable": true,
								"description": "Primer día con contabilidad en FacturaDirecta (YYYY-MM-DD). Los documentos anteriores no generan asientos"
							},
							"lockDate": {
								"type": "string",
								"nullable": true,
								"description": "Fecha de bloqueo contable (YYYY-MM-DD): no se pueden crear ni modificar documentos con fecha igual o anterior. `null` si no hay bloqueo"
							}
						}
					},
					"fiscal": {
						"type": "object",
						"title": "CompanySettingsFiscal",
						"description": "Situación de la empresa en los sistemas de facturación electrónica obligatoria. Afecta a qué pasa al emitir una factura: con VeriFactu o TicketBAI activos, cada factura emitida se registra o se envía a la administración y ya no se puede modificar ni borrar, solo rectificar",
						"required": [
							"verifactu",
							"ticketbai"
						],
						"additionalProperties": false,
						"properties": {
							"verifactu": {
								"type": "object",
								"title": "CompanySettingsVerifactu",
								"required": [
									"enabled",
									"environment",
									"mode",
									"startDate",
									"endDate",
									"exemption"
								],
								"additionalProperties": false,
								"properties": {
									"enabled": {
										"type": "boolean",
										"description": "Si las facturas de venta se registran bajo VeriFactu (o en modo No VeriFactu con registro local)"
									},
									"environment": {
										"type": "string",
										"nullable": true,
										"enum": [
											"verifactu_staging",
											"verifactu_production",
											null
										],
										"description": "Entorno de la AEAT. `verifactu_staging` es el de pruebas: los registros no tienen validez fiscal"
									},
									"mode": {
										"type": "string",
										"nullable": true,
										"enum": [
											"mode_verifactu",
											"mode_no_verifactu",
											null
										],
										"description": "`mode_verifactu` remite cada factura a la AEAT; `mode_no_verifactu` solo lleva el registro encadenado local"
									},
									"startDate": {
										"type": "string",
										"nullable": true,
										"description": "Fecha desde la que se registran las facturas (YYYY-MM-DD)"
									},
									"endDate": {
										"type": "string",
										"nullable": true,
										"description": "Fecha de fin de VeriFactu si la empresa dejó de aplicarlo (YYYY-12-31)"
									},
									"exemption": {
										"type": "string",
										"nullable": true,
										"enum": [
											"sii",
											null
										],
										"description": "Causa de exención declarada cuando no está activo (`sii`: opera bajo el Suministro Inmediato de Información)"
									}
								}
							},
							"ticketbai": {
								"type": "object",
								"title": "CompanySettingsTicketbai",
								"required": [
									"enabled",
									"environment",
									"region",
									"startDate"
								],
								"additionalProperties": false,
								"properties": {
									"enabled": {
										"type": "boolean",
										"description": "Si las facturas de venta se envían a TicketBAI (País Vasco)"
									},
									"environment": {
										"type": "string",
										"nullable": true,
										"enum": [
											"ticketbai_staging",
											"ticketbai_production",
											null
										],
										"description": "Entorno de la diputación. `ticketbai_staging` es el de pruebas"
									},
									"region": {
										"type": "string",
										"nullable": true,
										"enum": [
											"Araba",
											"Gipuzkoa",
											"Bizkaia",
											null
										],
										"description": "Diputación foral a la que se envían las facturas"
									},
									"startDate": {
										"type": "string",
										"nullable": true,
										"description": "Fecha desde la que se envían las facturas (YYYY-MM-DD)"
									}
								}
							}
						}
					},
					"email": {
						"type": "object",
						"title": "CompanySettingsEmail",
						"description": "Envío de documentos por correo desde FacturaDirecta",
						"required": [
							"from"
						],
						"additionalProperties": false,
						"properties": {
							"from": {
								"type": "array",
								"items": {
									"type": "string"
								},
								"description": "Remitentes disponibles para enviar documentos. El primero es el que se usa por defecto"
							}
						}
					},
					"stock": {
						"type": "object",
						"title": "CompanySettingsStock",
						"description": "Solo si la empresa tiene control de stock (`modules.stockControl`): qué documentos mueven el stock físico",
						"required": [
							"salesTrigger",
							"purchasesTrigger",
							"negativesPolicy",
							"defaultWarehouse"
						],
						"additionalProperties": false,
						"properties": {
							"salesTrigger": {
								"type": "string",
								"enum": [
									"deliveryNote",
									"invoice",
									"clientOrderDelivered"
								],
								"description": "Documento de venta que descuenta el stock: el albarán, la factura o la línea de pedido marcada como entregada"
							},
							"purchasesTrigger": {
								"type": "string",
								"enum": [
									"purchaseOrderReceived",
									"bill"
								],
								"description": "Documento de compra que incrementa el stock: la línea de orden de compra recibida o el gasto con líneas de producto"
							},
							"negativesPolicy": {
								"type": "string",
								"enum": [
									"warn",
									"block"
								],
								"description": "Qué pasa si un movimiento deja el stock en negativo: se permite con aviso (`warn`) o se rechaza el documento (`block`)"
							},
							"defaultWarehouse": {
								"type": "string",
								"nullable": true,
								"description": "Id del almacén por defecto para documentos y movimientos nuevos"
							}
						}
					},
					"clientPortal": {
						"type": "object",
						"title": "CompanySettingsClientPortal",
						"description": "Portal de cliente: enlaces públicos de consulta y pago de documentos",
						"required": [
							"includeLinkInEmails"
						],
						"additionalProperties": false,
						"properties": {
							"includeLinkInEmails": {
								"type": "boolean",
								"description": "Si los correos de envío de facturas incluyen el enlace al portal"
							}
						}
					},
					"inbox": {
						"type": "object",
						"title": "CompanySettingsInbox",
						"description": "Canales por los que entran documentos en la bandeja (`/inbox`), además de la API (`POST /uploads` + `POST /inbox`) y de la subida manual desde la pantalla de Tareas. Todos producen items con el mismo esquema (`source`: `upload`, `inbox`, `googleDrive`, `scanner`).\n\n* **Buzón por correo** (`email`): la empresa tiene una dirección exclusiva; cualquier correo que llegue a ella crea un item por cada adjunto (facturas de compra, tickets o nóminas en PDF, imagen o Facturae), y el cuerpo del mensaje se guarda como un PDF adicional (`contentSubtype: inboxEmailBody`). No se verifica el remitente: trata la dirección como confidencial.\n* **Google Drive** (`googleDrive`): FacturaDirecta lee periódicamente una carpeta de Drive enlazada por el usuario y crea un item por cada fichero nuevo. El enlace se hace desde la interfaz.\n\nAmbos canales se activan desde Ajustes › Integraciones, no por API.",
						"required": [
							"email",
							"googleDrive"
						],
						"additionalProperties": false,
						"properties": {
							"email": {
								"type": "object",
								"title": "CompanySettingsInboxEmail",
								"required": [
									"active",
									"address",
									"autoScan"
								],
								"additionalProperties": false,
								"properties": {
									"active": {
										"type": "boolean",
										"description": "Si el buzón por correo está activado. Requiere `modules.inbox`"
									},
									"address": {
										"type": "string",
										"nullable": true,
										"description": "Dirección a la que reenviar los documentos. `null` si el buzón no está activo"
									},
									"autoScan": {
										"type": "boolean",
										"description": "Si los documentos recibidos se escanean automáticamente al llegar (planes con escaneos ilimitados). Si es `false` quedan en la bandeja con `status: pending` hasta que un usuario los escanee"
									}
								}
							},
							"googleDrive": {
								"type": "object",
								"title": "CompanySettingsInboxGoogleDrive",
								"required": [
									"linked",
									"folderId",
									"folderUrl",
									"error"
								],
								"additionalProperties": false,
								"properties": {
									"linked": {
										"type": "boolean",
										"description": "Si hay una carpeta de Google Drive enlazada. Requiere `modules.googleDrive`"
									},
									"folderId": {
										"type": "string",
										"nullable": true,
										"description": "Id de la carpeta de Drive que se sincroniza"
									},
									"folderUrl": {
										"type": "string",
										"nullable": true,
										"description": "URL de la carpeta en Google Drive, para abrirla o indicársela al usuario"
									},
									"error": {
										"type": "string",
										"nullable": true,
										"description": "Si la sincronización está detenida por un error permanente (credenciales caducadas, carpeta borrada), el mensaje que ve el usuario; el usuario debe volver a enlazar la carpeta desde la interfaz. `null` si sincroniza con normalidad"
									}
								}
							}
						}
					},
					"modules": {
						"type": "object",
						"title": "CompanySettingsModules",
						"description": "Funcionalidades disponibles en la empresa según su plan y lo contratado. Lo que no está disponible devuelve `403` o `409` en los endpoints que lo requieren",
						"required": [
							"accounting",
							"inventory",
							"stockControl",
							"inbox",
							"googleDrive",
							"payrollScanning",
							"multicurrency",
							"clientPortal",
							"recurringInvoices",
							"scans"
						],
						"additionalProperties": false,
						"properties": {
							"accounting": {
								"type": "boolean",
								"description": "Módulo de Contabilidad: informes contables (pérdidas y ganancias, balance, sumas y saldos) y asientos"
							},
							"inventory": {
								"type": "boolean",
								"description": "Módulo Inventario: pedidos de cliente y órdenes de compra"
							},
							"stockControl": {
								"type": "boolean",
								"description": "Control de stock de productos (parte del módulo Inventario)"
							},
							"inbox": {
								"type": "boolean",
								"description": "Buzón de gastos por correo"
							},
							"googleDrive": {
								"type": "boolean",
								"description": "Carga de gastos desde Google Drive"
							},
							"payrollScanning": {
								"type": "boolean",
								"description": "El escaneo extrae nóminas (`POST /inbox/{id}/proposePayroll`)"
							},
							"multicurrency": {
								"type": "boolean",
								"description": "Documentos en monedas distintas de la principal"
							},
							"clientPortal": {
								"type": "boolean",
								"description": "Portal de cliente"
							},
							"recurringInvoices": {
								"type": "boolean",
								"description": "Facturas recurrentes (`/recurring`)"
							},
							"scans": {
								"type": "object",
								"title": "CompanySettingsScans",
								"description": "Escaneos de documentos de la bandeja incluidos en el plan",
								"required": [
									"period",
									"limit"
								],
								"additionalProperties": false,
								"properties": {
									"period": {
										"type": "string",
										"enum": [
											"month",
											"total"
										],
										"description": "Si el límite es mensual o una asignación total"
									},
									"limit": {
										"type": "integer",
										"description": "Escaneos incluidos: `-1` ilimitados, `0` el plan no incluye escaneos"
									}
								}
							}
						}
					},
					"webUrl": {
						"type": "string",
						"format": "uri",
						"description": "Página de Ajustes de la empresa en la aplicación web, donde un usuario puede cambiar esta configuración (pide iniciar sesión). No es un endpoint de la API"
					}
				}
			},
			"Contact": {
				"type": "object",
				"title": "Contact",
				"required": [
					"main",
					"type",
					"uuid"
				],
				"additionalProperties": false,
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"contact"
						]
					},
					"uuid": {
						"type": "string"
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"main": {
						"type": "object",
						"title": "ContactMain",
						"required": [
							"country",
							"name",
							"currency",
							"accounts"
						],
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Atributo \"Mostrar como\" o \"Nombre comercial\".\n\t\t\t\t\t\nPuedes indicar aquí el nombre comercial del contacto o el nombre fiscal con algún añadido si lo necesitas para identificarlo correctamente.\n\nEste campo se genera automáticamente a partir del nombre fiscal si se guarda el contacto sin este valor indicado."
							},
							"name": {
								"type": "string",
								"description": "Nombre fiscal del contacto para empresas o primer nombre para personas físicas"
							},
							"surname": {
								"type": "string",
								"description": "Apellidos del contacto. Debe indicarse solo para personas físicas"
							},
							"email": {
								"type": "string"
							},
							"phone": {
								"type": "string"
							},
							"address": {
								"type": "string",
								"description": "Detalles de la dirección: calle, número, anexos..."
							},
							"zipcode": {
								"type": "string",
								"description": "Código postal"
							},
							"city": {
								"type": "string",
								"description": "Localidad"
							},
							"region": {
								"type": "string",
								"description": "Provincia o región.\n\nPara contactos españoles se calcula automáticamente a partir del código postal."
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (Formato ISO 3166-1 Alpha-2)"
							},
							"fullAddress": {
								"type": "string",
								"description": "Dirección completa en formato texto libre.\n\nPara contactos españoles: Se calcula automáticamente a partir de los campos estructurados (address, zipcode, city). No rellenar manualmente.\nPara otros países: Se recomienda usar los campos estructurados (address, zipcode, city, region) en lugar de fullAddress."
							},
							"fiscalId": {
								"type": "string",
								"description": "Identificador fiscal del contacto.\n\nPara contatos españoles se valida el formato del mismo y debe ser introducido sin ningún separador ni caracter para dar formato"
							},
							"fiscalIdCountry": {
								"type": "string",
								"description": "País del identificador fiscal (Formato ISO 3166-1 Alpha-2).\n\nEste campo permite especificar el país asociado al identificador fiscal independientemente del país de la dirección del contacto."
							},
							"notes": {
								"type": "string"
							},
							"website": {
								"type": "string"
							},
							"contaplusCode": {
								"type": "string"
							},
							"clientCode": {
								"type": "string"
							},
							"providerCode": {
								"type": "string"
							},
							"accounts": {
								"type": "object",
								"additionalProperties": false,
								"title": "Accounts",
								"description": "Cuentas contables del contacto en los diferentes roles:\n\n* client: Cuenta cuando actúa como cliente (habitualmente 430000)\n* clientCredit: Cuenta de anticipos cuando actúa como cliente (habitualmente 438000)\n* provider: Cuenta cuando actúa como proveedor (habitualmente 400000 o 410000)\n* providerCredit: Cuenta de anticipos cuando actúa como proveedor (habitualmente 407000)\n* employee: Cuenta cuanto actúa como empleado (habitualmente 465000)\n* employeeCredit: Cuenta de anticipos cuanto actúa como empleado (habitualmente 460000)\n* providerDefaultPurchases: Cuenta de gastos de un proveedor (habitualmente 600000)\n\nLas cuentas se deben indicar por pares: si se indica la cuenta principal (client, provider o employee) se recomienda indicar también la cuenta de anticipos correspondiente (clientCredit, providerCredit o employeeCredit).\n\n**Comportamiento en la API pública al crear un contacto:**\n* Si se envía vacío o no se indica, el contacto se creará como cliente con las cuentas contables por defecto de la empresa.\n* Si solo se indica la cuenta principal con el prefijo esperado (43 para client, 40/41 para provider, 46 para employee), la cuenta de anticipos se completará automáticamente con el valor por defecto de la empresa.",
								"properties": {
									"client": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"provider": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"clientCredit": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"providerCredit": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"employee": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"employeeCredit": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"providerDefaultPurchases": {
										"$ref": "#/components/schemas/AccountCode"
									}
								}
							},
							"currency": {
								"type": "string",
								"description": "Moneda por defecto del contacto (Formato ISO 4217)"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprimen y se envían los documentos del contacto (código ISO 639-1, por ejemplo es, ca, en). Los documentos nuevos lo toman al asignar el contacto; sin valor, se imprimen en el idioma base de su plantilla"
							},
							"externalId": {
								"type": "string",
								"description": "ID externo del contacto. Debe ser único entre todos los contactos de la empresa"
							},
							"vatEU": {
								"type": "string",
								"description": "OBSOLETO: Usar fiscalId con fiscalIdType=\"02\" para identificadores intracomunitarios.\n\nEste campo se mantiene por compatibilidad. Para nuevos contactos intracomunitarios, usar fiscalId junto con fiscalIdType=\"02\" (NIF-IVA intracomunitario)."
							},
							"vatEUValidation": {
								"type": "object",
								"title": "VATEUValidation",
								"description": "Información de validación del NIF intracomunitario",
								"additionalProperties": false,
								"required": [
									"valid",
									"date"
								],
								"properties": {
									"valid": {
										"type": "boolean",
										"description": "Indica si el NIF intracomunitario ha sido validado y es válido"
									},
									"serviceAvailable": {
										"type": "boolean",
										"description": "Cuando el NIF intracomunitario no está indicado como válido este atributo es true cuando el NIF no se pudo validar porque el servicio de validación no estaba disponible en el momento de hacer la validación, el NIF podría ser válido en ese caso pero no se ha verificado."
									},
									"date": {
										"type": "string",
										"format": "date-time",
										"description": "Fecha y hora oficial devuelta por VIES para la comprobación. Las validaciones antiguas conservan la hora local que se guardó originalmente."
									},
									"vatEU": {
										"type": "string",
										"description": "El NIF intracomunitario que fue validado. Permite detectar si el vatEU actual del contacto coincide con el que se validó."
									},
									"requesterVatEU": {
										"type": "string",
										"description": "NIF-IVA verificado de la empresa que se envió como solicitante de la consulta."
									},
									"requestIdentifier": {
										"type": "string",
										"description": "Número de consulta devuelto por VIES para conservar como parte del recibo de validación."
									}
								}
							},
							"fiscalIdType": {
								"type": "string",
								"enum": [
									"NIF",
									"02",
									"03",
									"04",
									"05",
									"06",
									"07"
								],
								"description": "Tipo de identificador fiscal para VeriFactu.\n\nPermite especificar el tipo de documento de identificación fiscal del contacto según los códigos de VeriFactu:\n* NIF: NIF español (solo para contactos con país ES y NIF válido)\n* 02: NIF-IVA intracomunitario\n* 03: Pasaporte\n* 04: Documento oficial de identificación expedido por el país de residencia\n* 05: Certificado de residencia fiscal\n* 06: Otro documento probatorio\n* 07: No censado (solo para contactos con país ES)\n\nSi no se especifica, se infiere automáticamente del fiscalId y vatEU."
							},
							"sendPaymentMethod": {
								"type": "string",
								"nullable": true
							},
							"receivePaymentMethod": {
								"type": "string",
								"nullable": true
							},
							"receiveDueDateDelta": {
								"type": "integer",
								"minimum": 1
							},
							"receiveMonthDay": {
								"type": "number",
								"description": "Primer día preferido de pago del cliente.\n\nValores especiales: \n* 0: Cualquier día\n* -1: Último día del mes\n",
								"minimum": -1,
								"maximum": 28
							},
							"receiveMonthDay2": {
								"type": "number",
								"minimum": -1,
								"maximum": 28,
								"description": "Segundo día preferido de pago del cliente.\n\nValores especiales: \n* 0: Cualquier día\n* -1: Último día del mes\n"
							},
							"dir3": {
								"$ref": "#/components/schemas/ContactMainDir3"
							},
							"endCustomer": {
								"type": "boolean"
							},
							"fiscalPositions": {
								"type": "object",
								"additionalProperties": false,
								"title": "FiscalPositions",
								"description": "Posiciones fiscales del contacto en los diferentes roles:\n\n* sales: Posición fiscal cuando actúa como cliente\n* purchases: Posición fiscal cuando actúa como proveedor",
								"properties": {
									"sales": {
										"$ref": "#/components/schemas/FiscalPosition"
									},
									"purchases": {
										"$ref": "#/components/schemas/FiscalPosition"
									}
								}
							},
							"facturaeReceiver": {
								"type": "boolean",
								"description": "Solo disponible para contactos con rol de cliente, indica que acepta facturas en formato Facturae"
							},
							"countryFormatISO": {
								"type": "boolean",
								"description": "Permite mostrar el código ISO del país en lugar del nombre en los datos de facturación"
							},
							"persons": {
								"type": "array",
								"title": "ContactPersons",
								"description": "Interlocutores asociados al contacto",
								"items": {
									"$ref": "#/components/schemas/ContactPerson"
								}
							},
							"addresses": {
								"type": "array",
								"title": "ContactAddresses",
								"description": "Direcciones asociadas al contacto",
								"items": {
									"$ref": "#/components/schemas/ContactAddress"
								}
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable del contacto. Se usa para limitar la visibilidad a los contactos asignados al usuario."
							}
						}
					},
					"meta": {
						"type": "object",
						"title": "ContactMeta",
						"description": "Metadatos internos del contacto",
						"additionalProperties": false,
						"properties": {
							"nifValidation": {
								"$ref": "#/components/schemas/ContactMetaNifValidation"
							}
						}
					}
				}
			},
			"ContactAddress": {
				"type": "object",
				"title": "ContactAddress",
				"description": "Dirección asociada al contacto",
				"additionalProperties": false,
				"required": [
					"id",
					"label",
					"country"
				],
				"properties": {
					"id": {
						"type": "integer",
						"minimum": 1,
						"description": "Identificador interno de la dirección"
					},
					"label": {
						"type": "string",
						"description": "Título o descripción de la dirección"
					},
					"address": {
						"type": "string",
						"description": "Detalles de la dirección: calle, número, anexos..."
					},
					"zipcode": {
						"type": "string",
						"description": "Código postal"
					},
					"city": {
						"type": "string",
						"description": "Localidad"
					},
					"region": {
						"type": "string",
						"description": "Provincia o región"
					},
					"country": {
						"type": "string",
						"description": "País de la dirección (Formato ISO 3166-1 Alpha-2)"
					},
					"fullAddress": {
						"type": "string",
						"description": "Dirección completa en formato libre"
					},
					"uses": {
						"$ref": "#/components/schemas/ContactUses",
						"description": "Marcadores de uso preferente para esta dirección (una dirección por uso)."
					}
				}
			},
			"ContactMainDir3": {
				"type": "object",
				"title": "ContactMainDir3",
				"additionalProperties": false,
				"properties": {
					"fiscal": {
						"$ref": "#/components/schemas/ContactMainDir3Centre"
					},
					"receptor": {
						"$ref": "#/components/schemas/ContactMainDir3Centre"
					},
					"pagador": {
						"$ref": "#/components/schemas/ContactMainDir3Centre"
					},
					"comprador": {
						"$ref": "#/components/schemas/ContactMainDir3Centre"
					}
				}
			},
			"ContactMainDir3Centre": {
				"type": "object",
				"title": "ContactMainDir3Centre",
				"additionalProperties": false,
				"properties": {
					"centreCode": {
						"type": "string",
						"maxLength": 10
					}
				}
			},
			"ContactMetaNifValidation": {
				"type": "object",
				"title": "ContactMetaNifValidation",
				"additionalProperties": false,
				"required": [
					"nif",
					"name",
					"valid",
					"resultAEAT",
					"validationDate"
				],
				"properties": {
					"nif": {
						"type": "string",
						"description": "NIF usado para la validación"
					},
					"name": {
						"type": "string",
						"description": "Nombre usado para la validación"
					},
					"valid": {
						"type": "boolean",
						"description": "Indica si el NIF ha sido identificado correctamente por la AEAT y lo damos por válido para el nombre actual del contacto"
					},
					"resultAEAT": {
						"type": "string",
						"enum": [
							"identificado",
							"identificado-baja",
							"identificado-revocado",
							"no identificado-similar",
							"no identificado"
						],
						"description": "Indica el resultado de validación de la AEAT"
					},
					"validationDate": {
						"type": "string",
						"format": "date-time",
						"description": "Fecha y hora en la que se hizo la comprobación de la validez del NIF"
					},
					"validatedName": {
						"type": "string",
						"description": "Nombre devuelto por el servicio de validación cuando el NIF es válido"
					},
					"validatedNameScore": {
						"type": "number",
						"description": "Grado de similitud para el nombre de una empresa devuelto por el servicio de validación cuando el NIF es válido comparado con el enviado para validar"
					}
				}
			},
			"ContactPerson": {
				"type": "object",
				"title": "ContactPerson",
				"description": "Interlocutor asociado al contacto",
				"additionalProperties": false,
				"required": [
					"id",
					"name"
				],
				"properties": {
					"id": {
						"type": "integer",
						"minimum": 1,
						"description": "Identificador interno de la persona"
					},
					"name": {
						"type": "string",
						"description": "Nombre del interlocutor"
					},
					"surname": {
						"type": "string",
						"description": "Apellidos del interlocutor"
					},
					"jobTitle": {
						"type": "string",
						"description": "Cargo o función del interlocutor"
					},
					"emails": {
						"type": "array",
						"description": "Direcciones de correo electrónico del interlocutor",
						"items": {
							"type": "string"
						},
						"uniqueItems": true
					},
					"phones": {
						"type": "array",
						"description": "Teléfonos asociados al interlocutor",
						"items": {
							"type": "string"
						},
						"uniqueItems": true
					},
					"uses": {
						"$ref": "#/components/schemas/ContactUses",
						"description": "Marcadores de uso preferente para este interlocutor (por ejemplo envío de factura). Pueden existir varios interlocutores con el mismo uso."
					}
				}
			},
			"ContactResponse": {
				"type": "object",
				"title": "ContactResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/Contact"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "ContactRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "ContactRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/PaymentMethodResponse"
											}
										]
									}
								}
							},
							"paymentMethods": {
								"type": "array",
								"title": "ContactPaymentMethods",
								"description": "Array de ids de los métodos de pago de este contacto. Los objetos completos estarán disponibles en related.objects[id]",
								"items": {
									"type": "string"
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"ContactUse": {
				"type": "string",
				"title": "ContactUse",
				"enum": [
					"invoice",
					"estimate",
					"deliveryNote"
				],
				"description": "Identifica los diferentes usos para los que se puede marcar una persona o dirección."
			},
			"ContactUses": {
				"type": "array",
				"title": "ContactUses",
				"description": "Lista de usos preferidos para los que se empleará esta persona o dirección.",
				"items": {
					"$ref": "#/components/schemas/ContactUse"
				},
				"uniqueItems": true,
				"minItems": 1
			},
			"ContactWrite": {
				"type": "object",
				"title": "ContactWrite",
				"required": [
					"main",
					"type"
				],
				"additionalProperties": false,
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"contact"
						]
					},
					"uuid": {
						"type": "string"
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"main": {
						"type": "object",
						"title": "ContactMain",
						"required": [
							"country",
							"name",
							"currency",
							"accounts"
						],
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Atributo \"Mostrar como\" o \"Nombre comercial\".\n\t\t\t\t\t\nPuedes indicar aquí el nombre comercial del contacto o el nombre fiscal con algún añadido si lo necesitas para identificarlo correctamente.\n\nEste campo se genera automáticamente a partir del nombre fiscal si se guarda el contacto sin este valor indicado."
							},
							"name": {
								"type": "string",
								"description": "Nombre fiscal del contacto para empresas o primer nombre para personas físicas"
							},
							"surname": {
								"type": "string",
								"description": "Apellidos del contacto. Debe indicarse solo para personas físicas"
							},
							"email": {
								"type": "string"
							},
							"phone": {
								"type": "string"
							},
							"address": {
								"type": "string",
								"description": "Detalles de la dirección: calle, número, anexos..."
							},
							"zipcode": {
								"type": "string",
								"description": "Código postal"
							},
							"city": {
								"type": "string",
								"description": "Localidad"
							},
							"region": {
								"type": "string",
								"description": "Provincia o región.\n\nPara contactos españoles se calcula automáticamente a partir del código postal."
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (Formato ISO 3166-1 Alpha-2)"
							},
							"fullAddress": {
								"type": "string",
								"description": "Dirección completa en formato texto libre.\n\nPara contactos españoles: Se calcula automáticamente a partir de los campos estructurados (address, zipcode, city). No rellenar manualmente.\nPara otros países: Se recomienda usar los campos estructurados (address, zipcode, city, region) en lugar de fullAddress."
							},
							"fiscalId": {
								"type": "string",
								"description": "Identificador fiscal del contacto.\n\nPara contatos españoles se valida el formato del mismo y debe ser introducido sin ningún separador ni caracter para dar formato"
							},
							"fiscalIdCountry": {
								"type": "string",
								"description": "País del identificador fiscal (Formato ISO 3166-1 Alpha-2).\n\nEste campo permite especificar el país asociado al identificador fiscal independientemente del país de la dirección del contacto."
							},
							"notes": {
								"type": "string"
							},
							"website": {
								"type": "string"
							},
							"contaplusCode": {
								"type": "string"
							},
							"clientCode": {
								"type": "string"
							},
							"providerCode": {
								"type": "string"
							},
							"accounts": {
								"type": "object",
								"additionalProperties": false,
								"title": "Accounts",
								"description": "Cuentas contables del contacto en los diferentes roles:\n\n* client: Cuenta cuando actúa como cliente (habitualmente 430000)\n* clientCredit: Cuenta de anticipos cuando actúa como cliente (habitualmente 438000)\n* provider: Cuenta cuando actúa como proveedor (habitualmente 400000 o 410000)\n* providerCredit: Cuenta de anticipos cuando actúa como proveedor (habitualmente 407000)\n* employee: Cuenta cuanto actúa como empleado (habitualmente 465000)\n* employeeCredit: Cuenta de anticipos cuanto actúa como empleado (habitualmente 460000)\n* providerDefaultPurchases: Cuenta de gastos de un proveedor (habitualmente 600000)\n\nLas cuentas se deben indicar por pares: si se indica la cuenta principal (client, provider o employee) se recomienda indicar también la cuenta de anticipos correspondiente (clientCredit, providerCredit o employeeCredit).\n\n**Comportamiento en la API pública al crear un contacto:**\n* Si se envía vacío o no se indica, el contacto se creará como cliente con las cuentas contables por defecto de la empresa.\n* Si solo se indica la cuenta principal con el prefijo esperado (43 para client, 40/41 para provider, 46 para employee), la cuenta de anticipos se completará automáticamente con el valor por defecto de la empresa.",
								"properties": {
									"client": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"provider": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"clientCredit": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"providerCredit": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"employee": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"employeeCredit": {
										"$ref": "#/components/schemas/AccountCode"
									},
									"providerDefaultPurchases": {
										"$ref": "#/components/schemas/AccountCode"
									}
								}
							},
							"currency": {
								"type": "string",
								"description": "Moneda por defecto del contacto (Formato ISO 4217)"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprimen y se envían los documentos del contacto (código ISO 639-1, por ejemplo es, ca, en). Los documentos nuevos lo toman al asignar el contacto; sin valor, se imprimen en el idioma base de su plantilla"
							},
							"externalId": {
								"type": "string",
								"description": "ID externo del contacto. Debe ser único entre todos los contactos de la empresa"
							},
							"vatEU": {
								"type": "string",
								"description": "OBSOLETO: Usar fiscalId con fiscalIdType=\"02\" para identificadores intracomunitarios.\n\nEste campo se mantiene por compatibilidad. Para nuevos contactos intracomunitarios, usar fiscalId junto con fiscalIdType=\"02\" (NIF-IVA intracomunitario)."
							},
							"vatEUValidation": {
								"type": "object",
								"title": "VATEUValidation",
								"description": "Información de validación del NIF intracomunitario",
								"additionalProperties": false,
								"required": [
									"valid",
									"date"
								],
								"properties": {
									"valid": {
										"type": "boolean",
										"description": "Indica si el NIF intracomunitario ha sido validado y es válido"
									},
									"serviceAvailable": {
										"type": "boolean",
										"description": "Cuando el NIF intracomunitario no está indicado como válido este atributo es true cuando el NIF no se pudo validar porque el servicio de validación no estaba disponible en el momento de hacer la validación, el NIF podría ser válido en ese caso pero no se ha verificado."
									},
									"date": {
										"type": "string",
										"format": "date-time",
										"description": "Fecha y hora oficial devuelta por VIES para la comprobación. Las validaciones antiguas conservan la hora local que se guardó originalmente."
									},
									"vatEU": {
										"type": "string",
										"description": "El NIF intracomunitario que fue validado. Permite detectar si el vatEU actual del contacto coincide con el que se validó."
									},
									"requesterVatEU": {
										"type": "string",
										"description": "NIF-IVA verificado de la empresa que se envió como solicitante de la consulta."
									},
									"requestIdentifier": {
										"type": "string",
										"description": "Número de consulta devuelto por VIES para conservar como parte del recibo de validación."
									}
								}
							},
							"fiscalIdType": {
								"type": "string",
								"enum": [
									"NIF",
									"02",
									"03",
									"04",
									"05",
									"06",
									"07"
								],
								"description": "Tipo de identificador fiscal para VeriFactu.\n\nPermite especificar el tipo de documento de identificación fiscal del contacto según los códigos de VeriFactu:\n* NIF: NIF español (solo para contactos con país ES y NIF válido)\n* 02: NIF-IVA intracomunitario\n* 03: Pasaporte\n* 04: Documento oficial de identificación expedido por el país de residencia\n* 05: Certificado de residencia fiscal\n* 06: Otro documento probatorio\n* 07: No censado (solo para contactos con país ES)\n\nSi no se especifica, se infiere automáticamente del fiscalId y vatEU."
							},
							"sendPaymentMethod": {
								"type": "string",
								"nullable": true
							},
							"receivePaymentMethod": {
								"type": "string",
								"nullable": true
							},
							"receiveDueDateDelta": {
								"type": "integer",
								"minimum": 1
							},
							"receiveMonthDay": {
								"type": "number",
								"description": "Primer día preferido de pago del cliente.\n\nValores especiales: \n* 0: Cualquier día\n* -1: Último día del mes\n",
								"minimum": -1,
								"maximum": 28
							},
							"receiveMonthDay2": {
								"type": "number",
								"minimum": -1,
								"maximum": 28,
								"description": "Segundo día preferido de pago del cliente.\n\nValores especiales: \n* 0: Cualquier día\n* -1: Último día del mes\n"
							},
							"dir3": {
								"$ref": "#/components/schemas/ContactMainDir3"
							},
							"endCustomer": {
								"type": "boolean"
							},
							"fiscalPositions": {
								"type": "object",
								"additionalProperties": false,
								"title": "FiscalPositions",
								"description": "Posiciones fiscales del contacto en los diferentes roles:\n\n* sales: Posición fiscal cuando actúa como cliente\n* purchases: Posición fiscal cuando actúa como proveedor",
								"properties": {
									"sales": {
										"$ref": "#/components/schemas/FiscalPosition"
									},
									"purchases": {
										"$ref": "#/components/schemas/FiscalPosition"
									}
								}
							},
							"facturaeReceiver": {
								"type": "boolean",
								"description": "Solo disponible para contactos con rol de cliente, indica que acepta facturas en formato Facturae"
							},
							"countryFormatISO": {
								"type": "boolean",
								"description": "Permite mostrar el código ISO del país en lugar del nombre en los datos de facturación"
							},
							"persons": {
								"type": "array",
								"title": "ContactPersons",
								"description": "Interlocutores asociados al contacto",
								"items": {
									"$ref": "#/components/schemas/ContactPerson"
								}
							},
							"addresses": {
								"type": "array",
								"title": "ContactAddresses",
								"description": "Direcciones asociadas al contacto",
								"items": {
									"$ref": "#/components/schemas/ContactAddress"
								}
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable del contacto. Se usa para limitar la visibilidad a los contactos asignados al usuario."
							}
						}
					},
					"meta": {
						"type": "object",
						"title": "ContactMeta",
						"description": "Metadatos internos del contacto",
						"additionalProperties": false,
						"properties": {
							"nifValidation": {
								"$ref": "#/components/schemas/ContactMetaNifValidation"
							}
						}
					}
				},
				"description": "Versión simplificada del contacto con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"CreateTaxDeclarationAeatFileResponse": {
				"type": "object",
				"title": "CreateTaxDeclarationAeatFileResponse",
				"required": [
					"url",
					"filename"
				],
				"additionalProperties": false,
				"properties": {
					"url": {
						"type": "string",
						"description": "URL desde la que descargar el fichero de presentación."
					},
					"filename": {
						"type": "string",
						"description": "Nombre del fichero, el mismo que descarga la web (`modelo_303.303`)."
					}
				}
			},
			"CreationDate": {
				"type": "string",
				"title": "CreationDate",
				"description": "Fecha de creación del objeto en el sistema (Formato ISO 8601 con representación de tiempo en UTC: \"YYYY-MM-DDTHH:mm:ss.sssZ\")",
				"format": "date-time"
			},
			"CustomField": {
				"type": "object",
				"title": "CustomField",
				"additionalProperties": false,
				"required": [
					"id",
					"title",
					"docTypes",
					"archived"
				],
				"properties": {
					"id": {
						"type": "string",
						"pattern": "^cfi_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
						"description": "Identificador estable del campo: prefijo cfi_ seguido de un UUID v4 en minúsculas."
					},
					"title": {
						"type": "string",
						"description": "Nombre visible del campo."
					},
					"docTypes": {
						"type": "array",
						"minItems": 1,
						"items": {
							"type": "string",
							"enum": [
								"invoice",
								"estimate",
								"deliveryNote",
								"clientOrder",
								"purchaseOrder",
								"bill",
								"payroll",
								"contact"
							]
						},
						"description": "Tipos de documento en los que se muestra el campo."
					},
					"archived": {
						"type": "boolean",
						"description": "Indica si el campo está borrado."
					}
				}
			},
			"DeliveryNote": {
				"type": "object",
				"title": "DeliveryNote",
				"required": [
					"uuid",
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"deliveryNote"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"main": {
						"type": "object",
						"title": "DeliveryNoteMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"baseState": {
								"type": "string",
								"enum": [
									"pending",
									"delivered",
									"closed",
									"rejected"
								],
								"description": "Estado base del albarán, este es el estado que se elige en el propio documento. El estado final del mismo puede ser distinto si existen documentos relacionados"
							},
							"deliveredDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha en la que el albarán se ha entregado al cliente. Se rellena típicamente al pasar `baseState` a `delivered`."
							},
							"deliveredTo": {
								"type": "string",
								"description": "Nombre de la persona del cliente que ha recibido la entrega (firmante o responsable de recepción). Se rellena típicamente al pasar `baseState` a `delivered`."
							},
							"deliveryReceipt": {
								"type": "object",
								"description": "Recibí firmado del albarán. La firma se guarda como imagen data URL y la fecha/hora se registra automáticamente al recoger la firma.",
								"additionalProperties": false,
								"properties": {
									"signatureImage": {
										"type": "string",
										"description": "Imagen de la firma manuscrita en formato data URL."
									},
									"signedAt": {
										"type": "string",
										"format": "date-time",
										"description": "Fecha y hora en la que se guardó la firma del recibí."
									}
								},
								"required": [
									"signatureImage",
									"signedAt"
								]
							},
							"rejectedDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha en la que el cliente ha rechazado el albarán. Se rellena típicamente al pasar `baseState` a `rejected`."
							},
							"rejectedBy": {
								"type": "string",
								"description": "Identificador o nombre del responsable del cliente que ha rechazado la entrega. Se rellena típicamente al pasar `baseState` a `rejected`."
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes del albarán (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumber"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"emails": {
								"type": "string"
							},
							"emailsCc": {
								"type": "string"
							},
							"emailsBcc": {
								"type": "string"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "DeliveryNoteLines",
								"items": {
									"$ref": "#/components/schemas/DeliveryNoteMainLine"
								}
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles del albarán",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/SalesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"manualTotals": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas del albarán, no serán visibles en el documento impreso"
							},
							"taxCalculationMode": {
								"type": "string",
								"enum": [
									"total",
									"lines"
								]
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable del albarán. Se usa para limitar la visibilidad a documentos asignados."
							}
						},
						"required": [
							"account",
							"currency",
							"baseState",
							"date",
							"docNumber",
							"dueDate",
							"fiscalPosition",
							"exchangeRate",
							"lines",
							"lineTotalDecimals",
							"linesTotal",
							"taxes",
							"taxIncludedPrices",
							"theme",
							"total"
						]
					},
					"meta": {
						"type": "object",
						"title": "DeliveryNoteMeta",
						"description": "Metadatos internos del albarán",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				}
			},
			"DeliveryNoteMainLine": {
				"type": "object",
				"title": "DeliveryNoteMainLine",
				"additionalProperties": false,
				"properties": {
					"origin": {
						"type": "string",
						"description": "Indica aquí el ID del documento de origen de esta línea si proviene de otro documento para que los documentos queden enlazados",
						"nullable": true
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "DeliveryNoteLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de ventas de la empresa con `GET /{companyId}/settings/taxes/sales`. Los albaranes documentan entregas y suelen heredar los impuestos del producto del catálogo si la línea proviene de uno.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.sales.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, exportación, OSS, recargo de equivalencia, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.sales`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					}
				},
				"required": [
					"account",
					"discount",
					"discountRate",
					"lineTotal",
					"quantity",
					"text",
					"unitPrice"
				]
			},
			"DeliveryNoteMainLineWrite": {
				"type": "object",
				"title": "DeliveryNoteMainLineWrite",
				"additionalProperties": false,
				"properties": {
					"origin": {
						"type": "string",
						"description": "Indica aquí el ID del documento de origen de esta línea si proviene de otro documento para que los documentos queden enlazados",
						"nullable": true
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "DeliveryNoteLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de ventas de la empresa con `GET /{companyId}/settings/taxes/sales`. Los albaranes documentan entregas y suelen heredar los impuestos del producto del catálogo si la línea proviene de uno.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.sales.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, exportación, OSS, recargo de equivalencia, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.sales`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					}
				},
				"required": [
					"quantity",
					"text",
					"unitPrice"
				],
				"description": "Versión de la línea de albarán para creación del documento"
			},
			"DeliveryNoteResponse": {
				"type": "object",
				"title": "DeliveryNoteResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/DeliveryNote"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "DeliveryNoteRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "DeliveryNoteRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/TaxDefinition"
											}
										]
									}
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"DeliveryNoteWrite": {
				"type": "object",
				"title": "DeliveryNoteWrite",
				"required": [
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"deliveryNote"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/AttachmentWrite"
						},
						"maxItems": 10
					},
					"main": {
						"type": "object",
						"title": "DeliveryNoteMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"baseState": {
								"type": "string",
								"enum": [
									"pending",
									"delivered",
									"closed",
									"rejected"
								],
								"description": "Estado base del albarán, este es el estado que se elige en el propio documento. El estado final del mismo puede ser distinto si existen documentos relacionados"
							},
							"deliveredDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha en la que el albarán se ha entregado al cliente. Se rellena típicamente al pasar `baseState` a `delivered`."
							},
							"deliveredTo": {
								"type": "string",
								"description": "Nombre de la persona del cliente que ha recibido la entrega (firmante o responsable de recepción). Se rellena típicamente al pasar `baseState` a `delivered`."
							},
							"deliveryReceipt": {
								"type": "object",
								"description": "Recibí firmado del albarán. La firma se guarda como imagen data URL y la fecha/hora se registra automáticamente al recoger la firma.",
								"additionalProperties": false,
								"properties": {
									"signatureImage": {
										"type": "string",
										"description": "Imagen de la firma manuscrita en formato data URL."
									},
									"signedAt": {
										"type": "string",
										"format": "date-time",
										"description": "Fecha y hora en la que se guardó la firma del recibí."
									}
								},
								"required": [
									"signatureImage",
									"signedAt"
								]
							},
							"rejectedDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha en la que el cliente ha rechazado el albarán. Se rellena típicamente al pasar `baseState` a `rejected`."
							},
							"rejectedBy": {
								"type": "string",
								"description": "Identificador o nombre del responsable del cliente que ha rechazado la entrega. Se rellena típicamente al pasar `baseState` a `rejected`."
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes del albarán (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumberWrite"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"emails": {
								"type": "string"
							},
							"emailsCc": {
								"type": "string"
							},
							"emailsBcc": {
								"type": "string"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "DeliveryNoteLines",
								"items": {
									"$ref": "#/components/schemas/DeliveryNoteMainLineWrite"
								}
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles del albarán",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/SalesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas del albarán, no serán visibles en el documento impreso"
							},
							"taxCalculationMode": {
								"type": "string",
								"enum": [
									"total",
									"lines"
								]
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable del albarán. Se usa para limitar la visibilidad a documentos asignados."
							}
						},
						"required": [
							"baseState",
							"docNumber",
							"lines"
						]
					},
					"meta": {
						"type": "object",
						"title": "DeliveryNoteMeta",
						"description": "Metadatos internos del albarán",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				},
				"description": "Versión simplificada del albarán con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"Accounting": {
				"type": "object",
				"title": "DocumentAccounting",
				"description": "Asiento contable generado por el documento",
				"additionalProperties": false,
				"properties": {
					"date": {
						"type": "string",
						"format": "date",
						"nullable": true
					},
					"isMaintenance": {
						"type": "boolean"
					},
					"journalPriority": {
						"type": "number",
						"description": "Prioridad del asiento contable, determina el orden y tipo de apunte:\n\n- 1: Inicio de contabilidad / Apertura periodo\n- 2: Contabilidad fake previa al inicio\n- 3: Asiento de traspaso de beneficios en la apertura\n- 100: Asiento estándar\n- 970: Amortizaciones\n- 980: Regularización moneda extranjera\n- 990: Cierre grupos 6 y 7\n- 999: Cierre del periodo",
						"enum": [
							1,
							2,
							3,
							100,
							970,
							980,
							990,
							999
						]
					},
					"lines": {
						"type": "array",
						"title": "DocumentAccountingLines",
						"items": {
							"$ref": "#/components/schemas/AccountingLine"
						}
					}
				},
				"required": [
					"date",
					"lines"
				]
			},
			"AccountingLine": {
				"type": "object",
				"title": "DocumentAccountingLine",
				"description": "Apunte contable individual",
				"additionalProperties": false,
				"properties": {
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Referencia al documento que define la subcuenta de este apunte",
						"nullable": true
					},
					"debit": {
						"type": "number",
						"description": "Importe en el DEBE en la moneda de la contabilidad de la empresa",
						"nullable": true
					},
					"credit": {
						"type": "number",
						"description": "Importe en el HABER en la moneda de la contabilidad de la empresa",
						"nullable": true
					},
					"currencyDebit": {
						"type": "number",
						"description": "Importe en el DEBE en la moneda original del apunte",
						"nullable": true
					},
					"currencyCredit": {
						"type": "number",
						"description": "Importe en el HABER en la moneda original del apunte",
						"nullable": true
					},
					"currency": {
						"type": "string",
						"description": "Moneda original del apunte (Formato ISO 4217)"
					}
				},
				"required": [
					"account",
					"debit",
					"credit",
					"currencyDebit",
					"currencyCredit",
					"currency"
				]
			},
			"Books": {
				"type": "object",
				"title": "DocumentBooks",
				"additionalProperties": false,
				"properties": {
					"111": {
						"$ref": "#/components/schemas/BooksCellModel"
					},
					"115": {
						"$ref": "#/components/schemas/BooksCellModel"
					},
					"130": {
						"$ref": "#/components/schemas/BooksCellModel"
					},
					"180": {
						"$ref": "#/components/schemas/BooksCellModel"
					},
					"190": {
						"$ref": "#/components/schemas/BooksCellModel"
					},
					"303": {
						"$ref": "#/components/schemas/BooksCellModel"
					},
					"347": {
						"$ref": "#/components/schemas/BooksCellModel"
					},
					"349": {
						"$ref": "#/components/schemas/BooksCellModel"
					},
					"390": {
						"$ref": "#/components/schemas/BooksCellModel"
					}
				}
			},
			"BooksCellModel": {
				"type": "object",
				"title": "DocumentBooksCellModel",
				"required": [
					"manual",
					"date",
					"cells"
				],
				"additionalProperties": false,
				"properties": {
					"manual": {
						"type": "boolean"
					},
					"date": {
						"type": "string",
						"format": "date"
					},
					"cells": {
						"type": "object",
						"title": "BookCells",
						"description": "Datos de las distintas celdas que componen el modelo",
						"additionalProperties": true
					}
				}
			},
			"DocumentCounterpart": {
				"type": "object",
				"title": "DocumentCounterpart",
				"description": "Datos de la contraparte del documento cuando difieren del contacto asociado",
				"additionalProperties": false,
				"properties": {
					"name": {
						"type": "string",
						"description": "Nombre fiscal del contacto para empresas o primer nombre para personas físicas"
					},
					"surname": {
						"type": "string",
						"description": "Apellidos del contacto. Debe indicarse solo para personas físicas"
					},
					"fiscalIdType": {
						"type": "string",
						"enum": [
							"NIF",
							"02",
							"03",
							"04",
							"05",
							"06",
							"07"
						],
						"description": "Tipo de identificador fiscal según códigos VeriFactu"
					},
					"fiscalId": {
						"type": "string",
						"description": "Identificador fiscal de la contraparte"
					},
					"fiscalIdCountry": {
						"type": "string",
						"description": "País del identificador fiscal de la contraparte (Formato ISO 3166-1 Alpha-2)"
					}
				}
			},
			"DocNumber": {
				"type": "object",
				"title": "DocumentNumber",
				"additionalProperties": false,
				"required": [
					"series",
					"formattedSeries"
				],
				"properties": {
					"number": {
						"type": "number",
						"description": "Número secuencial del documento",
						"nullable": true
					},
					"series": {
						"type": "string",
						"description": "Serie del documento"
					},
					"formattedSeries": {
						"type": "string",
						"description": "Plantilla de la serie del documento.\n\nSe pueden usar los siguientes valores:\n* \\#\\# para indicar el año actual con 2 dígitos\n* \\#\\#\\#\\# para indicar el año actual con 4 dígitos"
					}
				}
			},
			"DocNumberWrite": {
				"type": "object",
				"title": "DocumentNumber",
				"additionalProperties": false,
				"required": [
					"series"
				],
				"properties": {
					"number": {
						"type": "number",
						"description": "Número secuencial del documento",
						"nullable": true
					},
					"series": {
						"type": "string",
						"description": "Serie del documento"
					},
					"formattedSeries": {
						"type": "string",
						"description": "Plantilla de la serie del documento.\n\nSe pueden usar los siguientes valores:\n* \\#\\# para indicar el año actual con 2 dígitos\n* \\#\\#\\#\\# para indicar el año actual con 4 dígitos"
					}
				}
			},
			"PurchasesDocumentTaxes": {
				"title": "DocumentTaxesPurchases",
				"type": "array",
				"minItems": 0,
				"items": {
					"type": "object",
					"title": "DocumentTaxPurchases",
					"additionalProperties": false,
					"properties": {
						"id": {
							"type": "string"
						},
						"base": {
							"type": "number"
						},
						"companyCurrencyBase": {
							"type": "number"
						},
						"amount": {
							"type": "number"
						},
						"companyCurrencyAmount": {
							"type": "number"
						},
						"nonDeductible": {
							"type": "boolean",
							"enum": [
								true
							]
						}
					},
					"required": [
						"id",
						"base",
						"amount",
						"companyCurrencyAmount",
						"companyCurrencyBase"
					]
				}
			},
			"SalesDocumentTaxes": {
				"type": "array",
				"title": "DocumentTaxesSales",
				"minItems": 0,
				"items": {
					"type": "object",
					"title": "DocumentTaxSales",
					"additionalProperties": false,
					"properties": {
						"id": {
							"type": "string"
						},
						"base": {
							"type": "number"
						},
						"companyCurrencyBase": {
							"type": "number"
						},
						"amount": {
							"type": "number"
						},
						"companyCurrencyAmount": {
							"type": "number"
						}
					},
					"required": [
						"id",
						"base",
						"amount",
						"companyCurrencyAmount",
						"companyCurrencyBase"
					]
				}
			},
			"DocumentVersion": {
				"type": "object",
				"title": "DocumentVersion",
				"additionalProperties": false,
				"required": [
					"id",
					"timestamp",
					"type",
					"subtype",
					"username"
				],
				"properties": {
					"id": {
						"type": "integer",
						"description": "Identificador de la versión: el `id` de su registro de actividad (`GET /{companyId}/activity`)"
					},
					"timestamp": {
						"type": "string",
						"format": "date-time",
						"description": "Fecha y hora de la versión (ISO 8601, UTC)"
					},
					"type": {
						"type": "string",
						"enum": [
							"inserted",
							"updated",
							"unarchived",
							"archived"
						],
						"description": "Qué creó la versión: `inserted` (alta), `updated` (modificación), `archived` (eliminación; la copia es el documento al eliminarlo) o `unarchived` (recuperación)"
					},
					"subtype": {
						"type": "string",
						"nullable": true,
						"description": "Subtipo de la modificación, si lo tiene (por ejemplo, `voided` al anular una factura)"
					},
					"username": {
						"type": "string",
						"nullable": true,
						"description": "Usuario (email) que hizo el cambio, o el usuario de sistema de FacturaDirecta en las acciones automáticas"
					},
					"changedFields": {
						"type": "array",
						"items": {
							"type": "string"
						},
						"description": "Solo en las modificaciones: rutas de los campos que cambiaron respecto a la versión anterior (`main.dueDate`, `main.lines[2].unitPrice`, `attachments[0]`, `tags`). Como mucho 50. Se compara lo que edita el usuario: `main`, los adjuntos y las etiquetas; `accounting`, `books`, `meta` e `import` los rellena el servidor y no se comparan. No aparece si no hay versión anterior con la que comparar."
					},
					"changedFieldsTruncated": {
						"type": "boolean",
						"description": "`true` si cambiaron más campos de los que lista `changedFields`"
					}
				}
			},
			"DocumentVersionChange": {
				"type": "object",
				"title": "DocumentVersionChange",
				"additionalProperties": false,
				"required": [
					"path"
				],
				"properties": {
					"path": {
						"type": "string",
						"description": "Ruta del campo: `main.dueDate`, `main.lines[2].unitPrice`, `tags`…"
					},
					"before": {
						"description": "Valor en la versión anterior (cualquier tipo JSON). Falta si el campo no existía."
					},
					"after": {
						"description": "Valor en esta versión (cualquier tipo JSON). Falta si el campo ya no existe."
					}
				}
			},
			"Estimate": {
				"type": "object",
				"title": "Estimate",
				"required": [
					"uuid",
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"estimate"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"main": {
						"type": "object",
						"title": "EstimateMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"baseState": {
								"type": "string",
								"enum": [
									"pending",
									"closed",
									"accepted",
									"rejected"
								],
								"description": "Estado base del presupuesto, este es el estado que se elige en el propio documento. El estado final del mismo puede ser distinto si existen documentos relacionados"
							},
							"acceptedDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha en la que el cliente ha aceptado el presupuesto. Se rellena típicamente al pasar `baseState` a `accepted`."
							},
							"acceptedBy": {
								"type": "string",
								"description": "Identificador o nombre del responsable del cliente que ha aceptado el presupuesto. Se rellena típicamente al pasar `baseState` a `accepted`."
							},
							"rejectedDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha en la que el cliente ha rechazado el presupuesto. Se rellena típicamente al pasar `baseState` a `rejected`."
							},
							"rejectedBy": {
								"type": "string",
								"description": "Identificador o nombre del responsable del cliente que ha rechazado el presupuesto. Se rellena típicamente al pasar `baseState` a `rejected`."
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes del presupuesto (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumber"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"emails": {
								"type": "string"
							},
							"emailsCc": {
								"type": "string"
							},
							"emailsBcc": {
								"type": "string"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "EstimateLines",
								"items": {
									"$ref": "#/components/schemas/EstimateMainLine"
								}
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles del presupuesto",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/SalesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"manualTotals": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"isProforma": {
								"type": "boolean",
								"description": "Si es `true`, el presupuesto se trata como factura proforma: cambia el prefijo del PDF generado, la plantilla de email usada al enviarlo (`email_proforma` en vez de `email_estimate`) y el etiquetado interno del documento. No tiene efectos fiscales: no genera asientos contables, no se reporta a VeriFactu/TicketBAI y no consume serie de facturación. Una factura proforma sigue siendo, a nivel del sistema, un presupuesto."
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas del presupuesto, no serán visibles en el documento impreso"
							},
							"taxCalculationMode": {
								"type": "string",
								"enum": [
									"total",
									"lines"
								]
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable del presupuesto. Se usa para limitar la visibilidad a documentos asignados."
							}
						},
						"required": [
							"account",
							"currency",
							"baseState",
							"date",
							"docNumber",
							"dueDate",
							"exchangeRate",
							"fiscalPosition",
							"lines",
							"lineTotalDecimals",
							"linesTotal",
							"taxes",
							"taxIncludedPrices",
							"theme",
							"total"
						]
					},
					"meta": {
						"type": "object",
						"title": "EstimateMeta",
						"description": "Metadatos internos del presupuesto",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				}
			},
			"EstimateMainLine": {
				"type": "object",
				"title": "EstimateMainLine",
				"additionalProperties": false,
				"properties": {
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "EstimateLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de ventas de la empresa con `GET /{companyId}/settings/taxes/sales`. Pueden coincidir varios impuestos en una misma línea, típicamente IVA + retención de IRPF para servicios profesionales.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.sales.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, exportación, OSS, recargo de equivalencia, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.sales`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					}
				},
				"required": [
					"account",
					"discount",
					"discountRate",
					"lineTotal",
					"quantity",
					"text",
					"unitPrice"
				]
			},
			"EstimateMainLineWrite": {
				"type": "object",
				"title": "EstimateMainLineWrite",
				"additionalProperties": false,
				"properties": {
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "EstimateLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de ventas de la empresa con `GET /{companyId}/settings/taxes/sales`. Pueden coincidir varios impuestos en una misma línea, típicamente IVA + retención de IRPF para servicios profesionales.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.sales.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, exportación, OSS, recargo de equivalencia, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.sales`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					}
				},
				"required": [
					"quantity",
					"text",
					"unitPrice"
				],
				"description": "Versión de la línea de presupuesto para creación del documento"
			},
			"EstimateResponse": {
				"type": "object",
				"title": "EstimateResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/Estimate"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "EstimateRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "EstimateRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/TaxDefinition"
											}
										]
									}
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"EstimateWrite": {
				"type": "object",
				"title": "EstimateWrite",
				"required": [
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"estimate"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/AttachmentWrite"
						},
						"maxItems": 10
					},
					"main": {
						"type": "object",
						"title": "EstimateMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"baseState": {
								"type": "string",
								"enum": [
									"pending",
									"closed",
									"accepted",
									"rejected"
								],
								"description": "Estado base del presupuesto, este es el estado que se elige en el propio documento. El estado final del mismo puede ser distinto si existen documentos relacionados"
							},
							"acceptedDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha en la que el cliente ha aceptado el presupuesto. Se rellena típicamente al pasar `baseState` a `accepted`."
							},
							"acceptedBy": {
								"type": "string",
								"description": "Identificador o nombre del responsable del cliente que ha aceptado el presupuesto. Se rellena típicamente al pasar `baseState` a `accepted`."
							},
							"rejectedDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha en la que el cliente ha rechazado el presupuesto. Se rellena típicamente al pasar `baseState` a `rejected`."
							},
							"rejectedBy": {
								"type": "string",
								"description": "Identificador o nombre del responsable del cliente que ha rechazado el presupuesto. Se rellena típicamente al pasar `baseState` a `rejected`."
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes del presupuesto (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumberWrite"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"emails": {
								"type": "string"
							},
							"emailsCc": {
								"type": "string"
							},
							"emailsBcc": {
								"type": "string"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "EstimateLines",
								"items": {
									"$ref": "#/components/schemas/EstimateMainLineWrite"
								}
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles del presupuesto",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/SalesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"isProforma": {
								"type": "boolean",
								"description": "Si es `true`, el presupuesto se trata como factura proforma: cambia el prefijo del PDF generado, la plantilla de email usada al enviarlo (`email_proforma` en vez de `email_estimate`) y el etiquetado interno del documento. No tiene efectos fiscales: no genera asientos contables, no se reporta a VeriFactu/TicketBAI y no consume serie de facturación. Una factura proforma sigue siendo, a nivel del sistema, un presupuesto."
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas del presupuesto, no serán visibles en el documento impreso"
							},
							"taxCalculationMode": {
								"type": "string",
								"enum": [
									"total",
									"lines"
								]
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable del presupuesto. Se usa para limitar la visibilidad a documentos asignados."
							}
						},
						"required": [
							"baseState",
							"docNumber",
							"lines"
						]
					},
					"meta": {
						"type": "object",
						"title": "EstimateMeta",
						"description": "Metadatos internos del presupuesto",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				},
				"description": "Versión simplificada del presupuesto con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"FinancialReport": {
				"type": "object",
				"title": "FinancialReport",
				"additionalProperties": false,
				"required": [
					"meta",
					"rows",
					"diagnostics"
				],
				"properties": {
					"meta": {
						"type": "object",
						"title": "FinancialReportMeta",
						"additionalProperties": false,
						"required": [
							"report",
							"template",
							"currency",
							"detail",
							"policies",
							"columns",
							"generatedAt"
						],
						"properties": {
							"report": {
								"type": "string",
								"enum": [
									"profitLoss",
									"balanceSheet"
								]
							},
							"template": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"id",
									"variant",
									"version"
								],
								"description": "Modelo oficial del informe: `pyme` o `pymesfl` (entidades sin fines lucrativos), según la empresa",
								"properties": {
									"id": {
										"type": "string"
									},
									"variant": {
										"type": "string",
										"enum": [
											"pyme",
											"pymesfl"
										]
									},
									"version": {
										"type": "integer"
									}
								}
							},
							"currency": {
								"type": "string",
								"description": "Moneda de la empresa (ISO 4217), la de todos los importes"
							},
							"detail": {
								"type": "string",
								"enum": [
									"summary",
									"accounts",
									"full"
								]
							},
							"policies": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"includeClosure"
								],
								"properties": {
									"includeClosure": {
										"type": "boolean"
									},
									"excludeRevenueClearing": {
										"type": "boolean",
										"description": "Solo en pérdidas y ganancias"
									},
									"tags": {
										"type": "array",
										"items": {
											"type": "string"
										}
									}
								}
							},
							"columns": {
								"type": "array",
								"items": {
									"$ref": "#/components/schemas/ReportColumn"
								}
							},
							"generatedAt": {
								"type": "string",
								"format": "date-time"
							}
						}
					},
					"rows": {
						"type": "array",
						"description": "Filas en orden de presentación. Una fila cuyas columnas son todas cero no aparece, igual que en la web.",
						"items": {
							"type": "object",
							"title": "FinancialReportRow",
							"additionalProperties": false,
							"required": [
								"id",
								"kind",
								"level",
								"title",
								"values"
							],
							"properties": {
								"id": {
									"type": "string",
									"description": "Identificador estable: el epígrafe del modelo (`A_1`); un grupo añade su prefijo de cuenta (`A_1/700`) y una fila de detalle su cuenta y tercero (`A_1/700/700000/con_...`)"
								},
								"parentId": {
									"type": "string",
									"description": "Fila cuyo total incluye esta. Puede no estar en `rows` si todas sus columnas son cero."
								},
								"kind": {
									"type": "string",
									"enum": [
										"accounts",
										"sum",
										"group",
										"detail",
										"unregularizedResult",
										"imbalance"
									],
									"description": "Tipo de fila:\n\n* accounts: Epígrafe que suma cuentas\n* sum: Epígrafe que suma otros epígrafes\n* group: Grupo de cuentas de un epígrafe (`detail=accounts` o `full`)\n* detail: Cuenta y tercero (`detail=full`)\n* unregularizedResult: Resultado de pérdidas y ganancias aún sin regularizar, en el balance\n* imbalance: Diferencia entre activo y patrimonio neto más pasivo, en el balance"
								},
								"level": {
									"type": "integer",
									"description": "Nivel de sangría, el de la web"
								},
								"title": {
									"type": "string",
									"description": "Título en el idioma de la petición"
								},
								"accountPrefix": {
									"type": "string",
									"description": "Prefijo de cuenta de un grupo"
								},
								"account": {
									"type": "string",
									"description": "Cuenta de una fila de detalle"
								},
								"accountTitle": {
									"type": "string",
									"description": "Título de la cuenta en el plan contable"
								},
								"thirdParty": {
									"type": "object",
									"additionalProperties": false,
									"required": [
										"id",
										"type",
										"name"
									],
									"description": "Tercero de una fila de detalle",
									"properties": {
										"id": {
											"type": "string"
										},
										"type": {
											"type": "string",
											"nullable": true
										},
										"name": {
											"type": "string",
											"nullable": true
										}
									}
								},
								"values": {
									"type": "object",
									"description": "Valor de cada columna por su `id`: importe para las columnas de fechas y la diferencia, fracción para la variación y el peso (`null` si su base es cero)",
									"additionalProperties": {
										"type": "number",
										"nullable": true
									}
								}
							}
						}
					},
					"diagnostics": {
						"type": "array",
						"description": "Avisos contables del informe, los mismos que muestra la web",
						"items": {
							"type": "object",
							"title": "FinancialReportDiagnostic",
							"additionalProperties": false,
							"required": [
								"code",
								"severity",
								"message"
							],
							"properties": {
								"code": {
									"type": "string",
									"enum": [
										"unmappedBalances",
										"openingWithoutClosing",
										"closingWithoutOpening",
										"previousYearNotClosed",
										"imbalance"
									],
									"description": "Aviso:\n\n* unmappedBalances: Cuentas con saldo que no encajan en ningún epígrafe del modelo\n* openingWithoutClosing: Ejercicio con asiento de apertura sin cierre del anterior\n* closingWithoutOpening: Ejercicio anterior cerrado sin asiento de apertura\n* previousYearNotClosed: Ejercicio anterior sin regularizar: su resultado se suma al del ejercicio\n* imbalance: El balance no cuadra"
								},
								"severity": {
									"type": "string",
									"enum": [
										"info",
										"warning"
									]
								},
								"years": {
									"type": "array",
									"items": {
										"type": "string"
									}
								},
								"accounts": {
									"type": "array",
									"items": {
										"type": "object",
										"additionalProperties": false,
										"required": [
											"account",
											"amount"
										],
										"properties": {
											"account": {
												"type": "string"
											},
											"amount": {
												"type": "number"
											}
										}
									}
								},
								"message": {
									"type": "string",
									"description": "Explicación del aviso en el idioma de la petición"
								}
							}
						}
					}
				}
			},
			"FiscalPosition": {
				"type": "string",
				"title": "FiscalPosition",
				"enum": [
					"emp",
					"emp_ic",
					"emp_ic_novies",
					"emp_ex",
					"emp_isp",
					"ind",
					"ind_ic",
					"ind_ex",
					"aut",
					"aut_re",
					"aut_irpf_24",
					"aut_irpf_19",
					"aut_irpf_15",
					"aut_irpf_7",
					"aut_irpf_2",
					"aut_irpf_1",
					"aut_irpf_19_urbano"
				],
				"description": "Posición fiscal del contacto\n\n* emp: Empresa nacional (cliente) | Empresa nacional (proveedor)\n* emp_ic: Empresa intracomunitaria (cliente) | Empresa intracomunitaria (proveedor)\n* emp_ic_novies: Empresa intracomunitaria no VIES (cliente) | Empresa intracomunitaria no VIES\t(proveedor)\n* emp_ex: Empresa extracomunitaria (cliente) | Empresa extracomunitaria (proveedor)\n* emp_isp: Empresa nacional a la que emito facturas ISP (cliente) | Empresa nacional que emite facturas ISP (proveedor)\n* ind: Cliente final nacional (cliente)\n* ind_ic: Cliente final intracomunitario (cliente)\n* ind_ex: Cliente final extracomunitario (cliente)\n* aut: Autónomo (cliente) | Autónomo que emite facturas sin retencion (proveedor)\n* aut_re: Autónomo en régimen de Recargo de Equivalencia (cliente)\n* aut_irpf_24: Autónomo que me emite facturas con retencion 24% IRPF\t(proveedor)\n* aut_irpf_19: Autónomo que me emite facturas con retencion 19% IRPF\t(proveedor)\n* aut_irpf_15: Autónomo que me emite facturas con retencion 15% IRPF\t(proveedor)\n* aut_irpf_7: Autónomo que me emite facturas con retencion 7% IRPF\t(proveedor)\n* aut_irpf_2: Autónomo que me emite facturas con retencion 2% IRPF\t(proveedor)\n* aut_irpf_1: Autónomo que me emite facturas con retencion 1% IRPF\t(proveedor)\n* aut_irpf_19_urbano: Persona que me emite facturas con retencion 19% IRPF en concepto de alquiler urbano\t(proveedor)\n"
			},
			"GetTaxDeclarationsResponse": {
				"type": "object",
				"title": "GetTaxDeclarationsResponse",
				"required": [
					"pagination",
					"items"
				],
				"additionalProperties": false,
				"properties": {
					"pagination": {
						"$ref": "#/components/schemas/Pagination"
					},
					"items": {
						"type": "array",
						"title": "Items",
						"items": {
							"$ref": "#/components/schemas/TaxDeclarationResponse"
						}
					}
				}
			},
			"ImportInformation": {
				"type": "object",
				"title": "ImportInformation",
				"description": "Información interna del origen del objeto",
				"required": [
					"from"
				],
				"additionalProperties": true,
				"properties": {
					"from": {
						"type": "string",
						"pattern": "^[a-zA_Z]{1}[a-zA-Z0-9_]*$"
					}
				}
			},
			"InboxAttachment": {
				"type": "object",
				"title": "InboxAttachment",
				"additionalProperties": false,
				"required": [
					"name",
					"url",
					"creationTime"
				],
				"properties": {
					"name": {
						"type": "string",
						"description": "Nombre original del archivo"
					},
					"url": {
						"type": "string",
						"format": "uri",
						"description": "URL S3 pública del archivo. Permanente mientras el inbox no se borre físicamente."
					},
					"creationTime": {
						"type": "string",
						"format": "date-time",
						"description": "Fecha y hora en que el adjunto se creó"
					},
					"size": {
						"type": "integer",
						"description": "Tamaño en bytes"
					},
					"contentType": {
						"type": "string",
						"description": "MIME type"
					},
					"contentSubtype": {
						"type": "string",
						"enum": [
							"facturae",
							"inboxEmailBody"
						],
						"description": "Subtipo detectado automáticamente, si aplica"
					}
				}
			},
			"InboxExtractionInvoice": {
				"type": "object",
				"title": "InboxExtractionInvoice",
				"description": "Datos estructurados extraídos por el escáner. Los códigos como `invoiceType` (F1, F2, ...) y `format` (INVOICE, RECEIPT, ...) se exponen como strings sin tipar para no acoplar la API a la versión actual del extractor.",
				"additionalProperties": true,
				"properties": {
					"date": {
						"type": "string",
						"nullable": true,
						"format": "date"
					},
					"name": {
						"type": "string",
						"nullable": true,
						"description": "Nombre del emisor (o destinatario, según `direction`)"
					},
					"contact": {
						"type": "string",
						"nullable": true,
						"description": "NIF/CIF/identificación fiscal"
					},
					"number": {
						"type": "string",
						"nullable": true
					},
					"total": {
						"type": "number",
						"nullable": true
					},
					"currency": {
						"type": "string",
						"nullable": true
					},
					"direction": {
						"type": "string",
						"nullable": true,
						"description": "RECEIVE (compra) | EMIT (venta)"
					},
					"invoiceType": {
						"type": "string",
						"nullable": true,
						"description": "Tipo de factura AEAT (F1, F2, R1, ...)"
					},
					"format": {
						"type": "string",
						"nullable": true,
						"description": "Formato detectado (INVOICE, RECEIPT, ...)"
					},
					"category": {
						"type": "string",
						"nullable": true
					},
					"country": {
						"type": "string",
						"nullable": true
					},
					"zipcode": {
						"type": "string",
						"nullable": true
					},
					"summary": {
						"type": "string",
						"nullable": true
					},
					"annotation": {
						"type": "string",
						"nullable": true
					},
					"disbursement": {
						"type": "string",
						"nullable": true
					},
					"taxes": {
						"type": "array",
						"nullable": true,
						"items": {
							"type": "object",
							"additionalProperties": true,
							"properties": {
								"tax": {
									"type": "string"
								},
								"base": {
									"type": "number"
								},
								"rate": {
									"type": "number"
								},
								"amount": {
									"type": "number"
								}
							}
						}
					}
				}
			},
			"InboxExtractionPayroll": {
				"type": "object",
				"title": "InboxExtractionPayroll",
				"description": "Datos estructurados extraídos por el escáner para una nómina. El shape está pensado para que un agente cliente pueda mapearlos a `Payroll.main` con mínima ambigüedad: el campo `type` de cada deducción/aportación es un enum semántico (no una cuenta contable FD), de modo que el cliente decide cómo asignar cuentas. La cobertura del extractor varía según versión: el extractor v1 solo identifica empresario y total — los demás campos vendrán en una iteración futura del extractor sin breaking changes para el cliente.",
				"additionalProperties": true,
				"required": [
					"date",
					"currency",
					"period",
					"employee",
					"employer",
					"earnings",
					"employeeDeductions",
					"employerContributions",
					"totals"
				],
				"properties": {
					"date": {
						"type": "string",
						"nullable": true,
						"format": "date",
						"description": "Fecha del documento (suele coincidir con `period.to`)"
					},
					"currency": {
						"type": "string",
						"nullable": true,
						"description": "Divisa de los importes (ISO 4217)"
					},
					"period": {
						"type": "object",
						"title": "InboxExtractionPayrollPeriod",
						"nullable": true,
						"additionalProperties": false,
						"description": "Período liquidado por la nómina.",
						"required": [
							"from",
							"to",
							"days"
						],
						"properties": {
							"from": {
								"type": "string",
								"nullable": true,
								"format": "date",
								"description": "Fecha de inicio del período"
							},
							"to": {
								"type": "string",
								"nullable": true,
								"format": "date",
								"description": "Fecha de fin del período"
							},
							"days": {
								"type": "integer",
								"nullable": true,
								"description": "Días liquidados"
							}
						}
					},
					"employee": {
						"type": "object",
						"title": "InboxExtractionPayrollEmployee",
						"nullable": true,
						"additionalProperties": false,
						"description": "Datos identificativos del empleado (la persona que percibe la nómina).",
						"required": [
							"name",
							"fiscalId",
							"socialSecurityNumber",
							"category",
							"contributionGroup",
							"seniorityDate"
						],
						"properties": {
							"name": {
								"type": "string",
								"nullable": true,
								"description": "Nombre completo del empleado tal como aparece en el recibo"
							},
							"fiscalId": {
								"type": "string",
								"nullable": true,
								"description": "NIF/NIE del empleado"
							},
							"socialSecurityNumber": {
								"type": "string",
								"nullable": true,
								"description": "Número de afiliación a la Seguridad Social"
							},
							"category": {
								"type": "string",
								"nullable": true,
								"description": "Categoría profesional / puesto"
							},
							"contributionGroup": {
								"type": "string",
								"nullable": true,
								"description": "Grupo de cotización (01-11)"
							},
							"seniorityDate": {
								"type": "string",
								"nullable": true,
								"format": "date",
								"description": "Fecha de antigüedad / inicio en la empresa"
							}
						}
					},
					"employer": {
						"type": "object",
						"title": "InboxExtractionPayrollEmployer",
						"nullable": true,
						"additionalProperties": false,
						"description": "Datos identificativos del empresario (la empresa que paga la nómina).",
						"required": [
							"name",
							"fiscalId",
							"address",
							"zipcode",
							"city",
							"region",
							"contributionAccountCode"
						],
						"properties": {
							"name": {
								"type": "string",
								"nullable": true,
								"description": "Razón social del empresario"
							},
							"fiscalId": {
								"type": "string",
								"nullable": true,
								"description": "NIF/CIF del empresario"
							},
							"address": {
								"type": "string",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"nullable": true
							},
							"city": {
								"type": "string",
								"nullable": true
							},
							"region": {
								"type": "string",
								"nullable": true
							},
							"contributionAccountCode": {
								"type": "string",
								"nullable": true,
								"description": "Código de cuenta de cotización (CCC) de la empresa en la SS"
							}
						}
					},
					"earnings": {
						"type": "array",
						"description": "Conceptos devengados (sumando todos = `totals.grossEarnings`).",
						"items": {
							"type": "object",
							"additionalProperties": false,
							"required": [
								"label",
								"amount"
							],
							"properties": {
								"label": {
									"type": "string",
									"description": "Concepto tal como aparece en el recibo (p.ej. \"Salari base\", \"Plus conveni\")"
								},
								"amount": {
									"type": "number",
									"description": "Importe devengado del concepto"
								},
								"contributable": {
									"type": "boolean",
									"nullable": true,
									"description": "Si cotiza a la Seguridad Social"
								},
								"taxable": {
									"type": "boolean",
									"nullable": true,
									"description": "Si está sujeto a IRPF"
								},
								"category": {
									"type": "string",
									"nullable": true,
									"enum": [
										"salary",
										"non_salary_compensation",
										"non_salary_supply",
										"non_salary_ss_benefit",
										"non_salary_other",
										null
									],
									"description": "Naturaleza del concepto. El cliente lo mapea a la cuenta contable correcta. Si se omite o `null`, se asume `salary`. Valores:\n- `salary`: percepción salarial (cotizable o no) que es gasto de la empresa → cuenta 640000.\n- `non_salary_compensation`: indemnizaciones por despido/fin de contrato, dietas no exentas → cuenta 641000.\n- `non_salary_supply`: suplidos, dietas/locomoción exentas → cuenta 640000 (debitType nonSalary).\n- `non_salary_ss_benefit`: prestaciones e indemnizaciones de la Seguridad Social pagadas por la empresa en **pago delegado** (IT por enfermedad común, maternidad/paternidad, riesgo embarazo INSS, etc.). NO son gasto de la empresa, son anticipos que se recuperan al liquidar el TC1 → cuenta 471000. Algunos programas (A3NOM) la etiquetan solo como \"Enfermedad\"/\"I.T.\"/\"Baja\" sin decir \"INSS\": una línea de enfermedad/IT SIN calificativo de empresa (\"Cargo Empresa\", \"Mejora\", \"Complemento\") es el pago delegado del INSS y queda excluida del \"COSTE EMPRESA\". El complemento de IT a cargo de la empresa (sí incluido en el coste) va en `salary`.\n- `non_salary_other`: otras percepciones no salariales que no encajan arriba → cuenta 640000 (debitType nonSalary)."
								}
							}
						}
					},
					"employeeDeductions": {
						"type": "array",
						"description": "Deducciones del trabajador.",
						"items": {
							"type": "object",
							"additionalProperties": false,
							"required": [
								"type",
								"amount"
							],
							"properties": {
								"type": {
									"type": "string",
									"description": "Tipo semántico de la deducción/aportación. Hoy reconocidos: `ss_common_contingencies`, `ss_mei`, `ss_unemployment`, `ss_professional_training`, `ss_wage_guarantee`, `ss_at_ep`, `irpf`, `other`. El agente cliente mapea estos códigos semánticos a la cuenta contable que corresponda (p.ej. `476000` para SS trabajador, `475100` para IRPF, `642000` para SS empresa)."
								},
								"base": {
									"type": "number",
									"nullable": true,
									"description": "Base sobre la que se calcula la deducción"
								},
								"rate": {
									"type": "number",
									"nullable": true,
									"description": "Porcentaje aplicado (p.ej. 4.70 para 4,70%)"
								},
								"amount": {
									"type": "number",
									"description": "Importe deducido o aportado"
								}
							}
						}
					},
					"employerContributions": {
						"type": "array",
						"description": "Aportaciones que paga la empresa (no descontadas al trabajador).",
						"items": {
							"type": "object",
							"additionalProperties": false,
							"required": [
								"type",
								"amount"
							],
							"properties": {
								"type": {
									"type": "string",
									"description": "Tipo semántico de la deducción/aportación. Hoy reconocidos: `ss_common_contingencies`, `ss_mei`, `ss_unemployment`, `ss_professional_training`, `ss_wage_guarantee`, `ss_at_ep`, `irpf`, `other`. El agente cliente mapea estos códigos semánticos a la cuenta contable que corresponda (p.ej. `476000` para SS trabajador, `475100` para IRPF, `642000` para SS empresa)."
								},
								"base": {
									"type": "number",
									"nullable": true,
									"description": "Base sobre la que se calcula la deducción"
								},
								"rate": {
									"type": "number",
									"nullable": true,
									"description": "Porcentaje aplicado (p.ej. 4.70 para 4,70%)"
								},
								"amount": {
									"type": "number",
									"description": "Importe deducido o aportado"
								}
							}
						}
					},
					"totals": {
						"type": "object",
						"title": "InboxExtractionPayrollTotals",
						"nullable": true,
						"additionalProperties": false,
						"description": "Importes agregados de la nómina, útiles para validación rápida.",
						"required": [
							"grossEarnings",
							"employeeDeductions",
							"netPay",
							"employerCost"
						],
						"properties": {
							"grossEarnings": {
								"type": "number",
								"nullable": true,
								"description": "Total devengado bruto"
							},
							"employeeDeductions": {
								"type": "number",
								"nullable": true,
								"description": "Total deducciones del trabajador (SS + IRPF + otras)"
							},
							"netPay": {
								"type": "number",
								"nullable": true,
								"description": "Líquido a percibir por el empleado"
							},
							"employerCost": {
								"type": "number",
								"nullable": true,
								"description": "Coste total para la empresa (\"COSTE EMPRESA\" del recibo). Suele ser la suma de las aportaciones del empresario a la SS, pero puede ser mayor si el recibo le añade conceptos a cargo de la empresa ya incluidos en devengos (p.ej. el complemento de IT/enfermedad a cargo de la empresa). No fuerces que `employerContributions[]` sume exactamente este importe."
							}
						}
					},
					"modelo190": {
						"type": "object",
						"nullable": true,
						"additionalProperties": false,
						"required": [
							"clavePercepcion"
						],
						"description": "Datos para el modelo 190 (declaración anual de retenciones).",
						"properties": {
							"clavePercepcion": {
								"type": "string",
								"nullable": true,
								"description": "Clave de percepción (A, B, ...)"
							}
						}
					}
				}
			},
			"InboxItem": {
				"type": "object",
				"title": "InboxItem",
				"additionalProperties": false,
				"required": [
					"id",
					"status",
					"source",
					"title",
					"createdAt",
					"updatedAt",
					"archived",
					"attachments",
					"scan"
				],
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador del item (prefijo `tas_`)"
					},
					"status": {
						"type": "string",
						"enum": [
							"pending",
							"scanned",
							"scan_failed"
						],
						"description": "Estado del escaneo. `pending`: aún no escaneado. `scanned`: escaneado con datos extraídos. `scan_failed`: escaneado sin datos extraíbles."
					},
					"source": {
						"type": "string",
						"enum": [
							"upload",
							"inbox",
							"googleDrive",
							"scanner"
						],
						"description": "Origen del item: `upload` (subido vía API pública POST /inbox), `inbox` (recibido por email vía Mailgun), `googleDrive` (sincronizado desde Google Drive), `scanner` (subido manualmente desde la pantalla de Tareas)."
					},
					"title": {
						"type": "string"
					},
					"createdAt": {
						"type": "string",
						"format": "date-time"
					},
					"updatedAt": {
						"type": "string",
						"format": "date-time"
					},
					"archived": {
						"type": "boolean",
						"description": "Si está archivado (DELETE archiva en lugar de borrar). Por defecto el listado solo devuelve items no archivados."
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/InboxAttachment"
						}
					},
					"scan": {
						"type": "object",
						"nullable": true,
						"title": "InboxScan",
						"description": "Información del escaneo del documento. `null` mientras `status` = `pending`. `text` solo se incluye en GET por id, no en list.",
						"additionalProperties": false,
						"required": [
							"completedAt",
							"docType",
							"mimeType",
							"extraction"
						],
						"properties": {
							"completedAt": {
								"type": "string",
								"format": "date-time",
								"nullable": true,
								"description": "Cuándo terminó el escaneo"
							},
							"docType": {
								"type": "string",
								"nullable": true,
								"description": "Tipo de documento detectado (p.ej. `IMAGE`)"
							},
							"mimeType": {
								"type": "string",
								"nullable": true
							},
							"text": {
								"type": "string",
								"nullable": true,
								"description": "Texto OCR completo. Solo en GET /inbox/{id}, no en list."
							},
							"extraction": {
								"type": "object",
								"nullable": true,
								"title": "InboxExtraction",
								"description": "Resultado estructurado del escaneo. El discriminador `kind` indica el tipo y la propiedad homónima contiene los datos. Hoy se reconocen `invoice` y `payroll`. Versiones futuras pueden añadir nuevos `kind` (p.ej. `salesInvoice`) y un campo opcional `alternatives` sin romper la compatibilidad.",
								"additionalProperties": false,
								"required": [
									"kind"
								],
								"properties": {
									"kind": {
										"type": "string",
										"description": "Tipo de extracción. Hoy: `invoice` o `payroll`."
									},
									"invoice": {
										"$ref": "#/components/schemas/InboxExtractionInvoice"
									},
									"payroll": {
										"$ref": "#/components/schemas/InboxExtractionPayroll"
									}
								}
							},
							"error": {
								"type": "object",
								"description": "Presente si `status` = `scan_failed`. La API no persiste el mensaje original del extractor; se devuelve uno genérico.",
								"required": [
									"message"
								],
								"properties": {
									"message": {
										"type": "string"
									}
								}
							}
						}
					}
				}
			},
			"Installments": {
				"type": "array",
				"title": "Installments",
				"description": "Calendario de vencimientos de la factura. Envía un elemento por cada cobro o pago previsto; cuando hay varios, cada vencimiento pendiente se puede incluir por separado en la remesa SEPA correspondiente. Cada elemento requiere `date`, `amount` y `currency`. Si se informa este campo, `dueDate` se ajusta a la fecha más tardía del calendario.",
				"items": {
					"type": "object",
					"title": "DocumentMainInstallment",
					"description": "Un vencimiento del calendario de cobros o pagos de la factura.",
					"additionalProperties": false,
					"properties": {
						"date": {
							"type": "string",
							"format": "date",
							"description": "Fecha del vencimiento en formato `YYYY-MM-DD`."
						},
						"amount": {
							"type": "number",
							"description": "Importe previsto para este vencimiento."
						},
						"currency": {
							"type": "string",
							"description": "Moneda del importe del vencimiento en formato ISO 4217."
						}
					},
					"required": [
						"date",
						"amount",
						"currency"
					]
				},
				"example": [
					{
						"date": "2026-07-15",
						"amount": 60.5,
						"currency": "EUR"
					},
					{
						"date": "2026-08-15",
						"amount": 60.5,
						"currency": "EUR"
					}
				]
			},
			"Invoice": {
				"type": "object",
				"additionalProperties": false,
				"title": "Invoice",
				"required": [
					"uuid",
					"type",
					"main"
				],
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"invoice"
						]
					},
					"accounting": {
						"$ref": "#/components/schemas/Accounting",
						"readOnly": true
					},
					"books": {
						"$ref": "#/components/schemas/Books",
						"readOnly": true
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"main": {
						"type": "object",
						"title": "InvoiceMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (cliente) (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"description": "Código postal de la dirección fiscal del contacto",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes de la factura (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"depreciable": {
								"type": "boolean"
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumber"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"emails": {
								"type": "string",
								"description": "Lista de emails separados por comas de los destinatarios a los que se enviará por defecto esta factura"
							},
							"emailsCc": {
								"type": "string",
								"description": "Lista de emails separados por comas de los destinatarios a los que se enviará por defecto en copia visible esta factura"
							},
							"emailsBcc": {
								"type": "string",
								"description": "Lista de emails separados por comas de los destinatarios a los que se enviará por defecto en copia oculta esta factura"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "InvoiceLines",
								"description": "Líneas de la factura",
								"items": {
									"$ref": "#/components/schemas/InvoiceMainLine"
								}
							},
							"manualAccounting": {
								"$ref": "#/components/schemas/InvoiceMainManualAccounting"
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles de la factura",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/SalesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"manualTotals": {
								"type": "boolean"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"pendingBeforeAccounting": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"correctedInvoice": {
								"type": "string",
								"description": "ID de la factura rectificada para una factura rectificativa"
							},
							"facturae": {
								"$ref": "#/components/schemas/InvoiceMainFacturae"
							},
							"externalId": {
								"type": "string"
							},
							"installments": {
								"$ref": "#/components/schemas/Installments"
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas de la factura, no serán visibles en el documento impreso"
							},
							"draft": {
								"type": "boolean",
								"description": "Indica si la factura es provisional (true) o definitiva (false). Una factura provisional no tiene número, se puede editar libremente y no tiene efecto contable ni fiscal. Guardarla como definitiva la emite: se le asigna número y, si la empresa tiene VeriFactu o TicketBAI activos y la factura no es externa, se genera el registro fiscal y se envía a la AEAT o a la Diputación Foral en ese mismo momento. Una factura definitiva no vuelve a ser provisional y, con esos sistemas, ya no se puede modificar ni borrar: solo anular, rectificar o, con VeriFactu, subsanar. Si no se indica al crear la factura, se aplica la configuración de la empresa (sales.newInvoiceMode), que puede ser definitiva: indícalo siempre de forma explícita."
							},
							"voided": {
								"type": "boolean",
								"description": "Indica si es una factura anulada. Anular es declarar que la factura no tenía que emitirse: conserva su número y queda visible como anulada. Si la factura tenía que existir pero contiene errores, lo que corresponde es subsanarla (VeriFactu) o emitir una rectificativa. Con VeriFactu o TicketBAI activos, la anulación se comunica a la administración y no se puede revertir; sin ellos, volver a poner voided a false restaura la factura."
							},
							"external": {
								"type": "boolean",
								"description": "Indica que es una factura externa creada fuera del programa. Genera contabilidad e impuestos normalmente, pero NO genera información para VeriFactu ni TicketBAI."
							},
							"corrective": {
								"type": "boolean",
								"description": "Indica si la factura es rectificativa. Fuente de verdad única para determinar si una factura es rectificativa."
							},
							"substitution": {
								"type": "boolean",
								"description": "Indica que es una factura que sustituye a otras facturas simplificadas (corresponde a F3 en VeriFactu). No genera contabilidad, solo genera información para el modelo 347."
							},
							"substitutedInvoices": {
								"type": "array",
								"items": {
									"type": "string"
								},
								"description": "Array de UUIDs de facturas simplificadas que esta factura sustituye. Solo tiene sentido cuando substitution === true."
							},
							"taxCalculationMode": {
								"type": "string",
								"enum": [
									"total",
									"lines"
								]
							},
							"verifactu": {
								"$ref": "#/components/schemas/InvoiceMainVerifactu"
							},
							"ticketbai": {
								"$ref": "#/components/schemas/InvoiceMainTicketbai"
							},
							"simplified": {
								"type": "boolean",
								"description": "Indica si la factura es simplificada. Una factura es simplificada cuando no identifica al destinatario con datos fiscales completos."
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable de la factura. Se usa para limitar la visibilidad a documentos asignados."
							}
						},
						"required": [
							"account",
							"currency",
							"date",
							"docNumber",
							"dueDate",
							"exchangeRate",
							"fiscalPosition",
							"lines",
							"lineTotalDecimals",
							"linesTotal",
							"simplified",
							"taxes",
							"taxIncludedPrices",
							"theme",
							"total",
							"draft",
							"voided",
							"corrective"
						]
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"meta": {
						"type": "object",
						"title": "InvoiceMeta",
						"description": "Metadatos internos de la factura",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							},
							"expeditionTimestamp": {
								"type": "string",
								"description": "Fecha y hora de expedición de la factura en formato ISO 8601 GMT (ej: 2025-12-05T10:00:02.893Z). Se inicializa automáticamente al guardar la factura por primera vez como definitiva."
							},
							"verifactu": {
								"$ref": "#/components/schemas/InvoiceMetaVerifactu"
							},
							"ticketbai": {
								"oneOf": [
									{
										"$ref": "#/components/schemas/InvoiceMetaTicketbai"
									},
									{
										"$ref": "#/components/schemas/InvoiceMetaBatuzNoSG"
									}
								]
							}
						},
						"readOnly": true
					}
				}
			},
			"InvoiceMainFacturae": {
				"type": "object",
				"title": "InvoiceMainFacturae",
				"additionalProperties": false,
				"properties": {
					"LegalReference": {
						"type": "string",
						"description": "Textos literales legales que deben figurar obligatoriamente en determinadas facturas"
					},
					"InvoicingPeriod": {
						"type": "object",
						"description": "Periodo de facturación. Solo cuando se requiera: servicio prestado temporalmente o factura recapitulativa. ISO 8601:2004",
						"additionalProperties": false,
						"required": [
							"StartDate",
							"EndDate"
						],
						"properties": {
							"StartDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha de inicio del periodo en formato yyyy-mm-dd"
							},
							"EndDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha de fin del periodo en formato yyyy-mm-dd"
							}
						}
					},
					"PlaceOfIssue": {
						"type": "object",
						"description": "Lugar de expedición. Plaza en la que se expide el documento",
						"additionalProperties": false,
						"required": [
							"PostCode"
						],
						"properties": {
							"PostCode": {
								"type": "string",
								"description": "Código postal del lugar de expedición"
							},
							"PlaceOfIssueDescription": {
								"type": "string",
								"description": "Texto del nombre del lugar de expedición"
							}
						}
					},
					"OperationDate": {
						"type": "string",
						"format": "date",
						"description": "Fecha de operación. Fecha en la que se realiza el servicio o se entrega el bien. Solo obligatoria si es distinta de la fecha de expedición"
					},
					"LanguageName": {
						"type": "string",
						"enum": [
							"ar",
							"be",
							"bg",
							"ca",
							"cs",
							"da",
							"de",
							"el",
							"en",
							"es",
							"et",
							"eu",
							"fi",
							"fr",
							"ga",
							"gl",
							"hr",
							"hu",
							"is",
							"it",
							"lv",
							"lt",
							"mk",
							"mt",
							"nl",
							"no",
							"pl",
							"pt",
							"ro",
							"ru",
							"sk",
							"sl",
							"sq",
							"sr",
							"sv",
							"tr",
							"uk"
						],
						"description": "Lengua. Código ISO 639-1:2002 Alpha-2 de la lengua en la que se emite el documento"
					},
					"Buyer_ContactPersons": {
						"type": "string",
						"description": "Persona de contacto del receptor: apellidos y nombre/razón social"
					},
					"AdministrativeCentre_01": {
						"$ref": "#/components/schemas/InvoiceMainFacturaeAdministrativeCentre",
						"description": "Centro administrativo 1"
					},
					"AdministrativeCentre_02": {
						"$ref": "#/components/schemas/InvoiceMainFacturaeAdministrativeCentre",
						"description": "Centro administrativo 2"
					},
					"AdministrativeCentre_03": {
						"$ref": "#/components/schemas/InvoiceMainFacturaeAdministrativeCentre",
						"description": "Centro administrativo 3"
					},
					"AdministrativeCentre_04": {
						"$ref": "#/components/schemas/InvoiceMainFacturaeAdministrativeCentre",
						"description": "Centro administrativo 4"
					},
					"AdministrativeCentre_05": {
						"$ref": "#/components/schemas/InvoiceMainFacturaeAdministrativeCentre",
						"description": "Centro administrativo 5"
					},
					"AdministrativeCentre_06": {
						"$ref": "#/components/schemas/InvoiceMainFacturaeAdministrativeCentre",
						"description": "Centro administrativo 6"
					},
					"AdministrativeCentre_07": {
						"$ref": "#/components/schemas/InvoiceMainFacturaeAdministrativeCentre",
						"description": "Centro administrativo 7"
					},
					"AdministrativeCentre_08": {
						"$ref": "#/components/schemas/InvoiceMainFacturaeAdministrativeCentre",
						"description": "Centro administrativo 8"
					},
					"AdministrativeCentre_09": {
						"$ref": "#/components/schemas/InvoiceMainFacturaeAdministrativeCentre",
						"description": "Centro administrativo 9"
					},
					"Corrective_ReasonCode": {
						"type": "string",
						"enum": [
							"01",
							"02",
							"03",
							"04",
							"05",
							"06",
							"07",
							"08",
							"09",
							"10",
							"11",
							"12",
							"13",
							"14",
							"15",
							"16",
							"80",
							"81",
							"82",
							"83",
							"84",
							"85"
						],
						"description": "Código del motivo de rectificación. Obligatorio para emitir facturae de una factura rectificativa. 01-16: errores según RD 1496/2003. 80-85: supuestos del Art. 80 Ley 37/92 del IVA"
					},
					"Corrective_CorrectionMethod": {
						"type": "string",
						"enum": [
							"02",
							"03"
						],
						"description": "Código del criterio empleado para la rectificación. 02: rectificación por diferencias. 03: rectificación por descuento por volumen de operaciones durante un periodo"
					},
					"Corrective_AdditionalReasonDescription": {
						"type": "string",
						"maxLength": 2500,
						"description": "Ampliación motivo de la rectificación. Descripción de las aclaraciones y motivos de la factura rectificativa"
					}
				}
			},
			"InvoiceMainFacturaeAdministrativeCentre": {
				"type": "object",
				"title": "InvoiceMainFacturaeAdministrativeCentre",
				"description": "Atributos de un centro administrativo para Facturae",
				"additionalProperties": false,
				"properties": {
					"CentreCode": {
						"type": "string"
					},
					"RoleTypeCode": {
						"type": "string"
					},
					"Name": {
						"type": "string"
					},
					"FirstSurname": {
						"type": "string"
					},
					"SecondSurname": {
						"type": "string"
					},
					"Address": {
						"type": "string"
					},
					"PostCode": {
						"type": "string"
					},
					"Town": {
						"type": "string"
					},
					"Province": {
						"type": "string"
					},
					"CountryCode": {
						"type": "string"
					},
					"PostCodeAndTown": {
						"type": "string"
					},
					"Telephone": {
						"type": "string"
					},
					"TeleFax": {
						"type": "string"
					},
					"WebAddress": {
						"type": "string"
					},
					"ElectronicMail": {
						"type": "string"
					},
					"ContactPersons": {
						"type": "string"
					},
					"CnoCnae": {
						"type": "string"
					},
					"INETownCode": {
						"type": "string"
					},
					"AdditionalContactDetails": {
						"type": "string"
					},
					"PhysicalGLN": {
						"type": "string"
					},
					"LogicalOperationalPoint": {
						"type": "string"
					},
					"CentreDescription": {
						"type": "string"
					}
				}
			},
			"InvoiceMainLine": {
				"type": "object",
				"title": "InvoiceMainLine",
				"description": "Línea de la factura",
				"additionalProperties": false,
				"properties": {
					"origin": {
						"type": "string",
						"description": "Indica aquí el ID del documento de origen de esta línea si proviene de otro documento para que los documentos queden enlazados",
						"nullable": true
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "InvoiceLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de ventas de la empresa con `GET /{companyId}/settings/taxes/sales`. Pueden coincidir varios impuestos en una misma línea, típicamente IVA + retención de IRPF para servicios profesionales.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.sales.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, exportación, OSS, recargo de equivalencia, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.sales`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					},
					"facturae": {
						"$ref": "#/components/schemas/InvoiceMainLineFacturae"
					},
					"verifactu": {
						"$ref": "#/components/schemas/InvoiceMainLineVerifactu"
					}
				},
				"required": [
					"account",
					"discount",
					"discountRate",
					"lineTotal",
					"quantity",
					"text",
					"unitPrice",
					"tax"
				]
			},
			"InvoiceMainLineFacturae": {
				"type": "object",
				"title": "InvoiceMainLineFacturae",
				"additionalProperties": false,
				"properties": {
					"IssuerContractReference": {
						"type": "string",
						"description": "Referencia del contrato del Emisor"
					},
					"IssuerContractDate": {
						"type": "string",
						"format": "date",
						"description": "Fecha asociada al atributo IssuerContractReference en formato yyyy-mm-dd"
					},
					"IssuerTransactionReference": {
						"type": "string",
						"description": "Referencia de la Operación, Número de Pedido, Contrato, etc. del Emisor"
					},
					"IssuerTransactionDate": {
						"type": "string",
						"format": "date",
						"description": "Fecha asociada al atributo IssuerTransactionReference en formato yyyy-mm-dd"
					},
					"ReceiverContractReference": {
						"type": "string",
						"description": "Referencia del contrato del Receptor"
					},
					"ReceiverContractDate": {
						"type": "string",
						"format": "date",
						"description": "Fecha del contrato del receptor en formato yyyy-mm-dd"
					},
					"ReceiverTransactionReference": {
						"type": "string",
						"description": "Referencia de la Operación, Número de Pedido, Contrato, etc. del Receptor"
					},
					"ReceiverTransactionDate": {
						"type": "string",
						"format": "date",
						"description": "Fecha asociada al atributo ReceiverTransactionReference en formato yyyy-mm-dd"
					},
					"FileReference": {
						"type": "string",
						"description": "Referencia del expediente"
					},
					"FileDate": {
						"type": "string",
						"format": "date",
						"description": "Fecha asociada al atributo FileReference en formato yyyy-mm-dd"
					},
					"DeliveryNotesReferences": {
						"type": "array",
						"description": "Referencias de albaranes",
						"items": {
							"type": "object",
							"title": "FacturaeDeliveryNotesReference",
							"additionalProperties": false,
							"required": [
								"DeliveryNoteNumber"
							],
							"properties": {
								"DeliveryNoteNumber": {
									"type": "string",
									"description": "Número de referencia del albarán"
								},
								"DeliveryNoteDate": {
									"type": "string",
									"format": "date",
									"description": "Fecha asociada al atributo DeliveryNoteNumber en formato yyyy-mm-dd"
								}
							}
						}
					},
					"SequenceNumber": {
						"type": "number",
						"description": "Número de secuencia o línea del pedido"
					},
					"LineItemPeriod": {
						"type": "object",
						"description": "Información sobre el periodo de prestación de un servicio. ISO 8601:2004",
						"required": [
							"StartDate",
							"EndDate"
						],
						"properties": {
							"StartDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha de inicio en formato yyyy-mm-dd"
							},
							"EndDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha de fin en formato yyyy-mm-dd"
							}
						}
					}
				}
			},
			"InvoiceMainLineVerifactu": {
				"type": "object",
				"title": "InvoiceMainLineVerifactu",
				"description": "Información a nivel de línea relativo a VeriFactu",
				"additionalProperties": false,
				"properties": {
					"ClaveRegimen": {
						"type": "string",
						"enum": [
							"01",
							"02",
							"03",
							"04",
							"05",
							"06",
							"07",
							"08",
							"09",
							"10",
							"11",
							"14",
							"15",
							"17",
							"18",
							"19",
							"20",
							"21"
						],
						"title": "VF_IdOperacionesTrascendenciaTributariaType"
					},
					"CalificacionOperacion": {
						"type": "string",
						"enum": [
							"S1",
							"S2",
							"N1",
							"N2"
						],
						"description": "* S1: OPERACIÓN SUJETA Y NO EXENTA - SIN INVERSIÓN DEL SUJETO PASIVO.\n* S2: OPERACIÓN SUJETA Y NO EXENTA - CON INVERSIÓN DEL SUJETO PASIVO\n* N1: OPERACIÓN NO SUJETA ARTÍCULO 7, 14, OTROS.\n* N2: OPERACIÓN NO SUJETA POR REGLAS DE LOCALIZACIÓN",
						"title": "VF_CalificacionOperacionType"
					},
					"OperacionExenta": {
						"type": "string",
						"enum": [
							"E1",
							"E2",
							"E3",
							"E4",
							"E5",
							"E6",
							"E7",
							"E8"
						],
						"title": "VF_OperacionExentaType"
					}
				}
			},
			"InvoiceMainLineWrite": {
				"type": "object",
				"title": "InvoiceMainLineWrite",
				"description": "Versión de la línea de factura para creación del documento",
				"additionalProperties": false,
				"properties": {
					"origin": {
						"type": "string",
						"description": "Indica aquí el ID del documento de origen de esta línea si proviene de otro documento para que los documentos queden enlazados",
						"nullable": true
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "InvoiceLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de ventas de la empresa con `GET /{companyId}/settings/taxes/sales`. Pueden coincidir varios impuestos en una misma línea, típicamente IVA + retención de IRPF para servicios profesionales.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.sales.tax`) como base y aplica automáticamente la posición fiscal del contacto (intracomunitario, exportación, OSS, recargo de equivalencia, etc.).\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.sales`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					},
					"facturae": {
						"$ref": "#/components/schemas/InvoiceMainLineFacturae"
					},
					"verifactu": {
						"$ref": "#/components/schemas/InvoiceMainLineVerifactu"
					}
				},
				"required": [
					"quantity",
					"text",
					"unitPrice"
				]
			},
			"InvoiceMainManualAccounting": {
				"type": "object",
				"title": "InvoiceMainManualAccounting",
				"description": "Contabilidad manual de la factura.\n\nEn este elemento pueden indicarse las líneas que se genearán en la contabilidad para esta factura a excepción de las del total del documento y las de impuestos que son generadas automáticamente por el programa",
				"additionalProperties": false,
				"properties": {
					"lines": {
						"type": "array",
						"title": "InvoiceMainManualAccountingLines",
						"minItems": 1,
						"items": {
							"$ref": "#/components/schemas/AccountingLine"
						}
					}
				},
				"required": [
					"lines"
				]
			},
			"InvoiceMainTicketbai": {
				"type": "object",
				"title": "InvoiceMainTicketbai",
				"description": "Parámetros de ajustes para TicketBAI",
				"additionalProperties": false,
				"properties": {
					"causaExencion": {
						"type": "string",
						"enum": [
							"E1",
							"E2",
							"E3",
							"E4",
							"E5",
							"E6"
						]
					},
					"causaNoSujeta": {
						"type": "string",
						"enum": [
							"OT",
							"RL",
							"VT",
							"IE"
						]
					},
					"claveTipoFacturaRectificativa": {
						"type": "string",
						"enum": [
							"R1",
							"R2",
							"R3",
							"R4",
							"R5"
						]
					},
					"batuzRentaIngresos": {
						"type": "array",
						"minItems": 1,
						"maxItems": 1,
						"items": {
							"type": "object",
							"additionalProperties": false,
							"required": [
								"epigrafe"
							],
							"properties": {
								"epigrafe": {
									"type": "string",
									"minLength": 1,
									"maxLength": 7
								}
							}
						}
					}
				}
			},
			"InvoiceMainVerifactu": {
				"type": "object",
				"title": "InvoiceMainVerifactu",
				"description": "Información a nivel de factura relativo a VeriFactu",
				"additionalProperties": false,
				"properties": {
					"TipoFactura": {
						"type": "string",
						"enum": [
							"F1",
							"F2",
							"R1",
							"R2",
							"R3",
							"R4",
							"R5",
							"F3"
						],
						"description": "* F1: FACTURA (ART. 6, 7.2 Y 7.3 DEL RD 1619/2012)\n* F2: FACTURA SIMPLIFICADA Y FACTURAS SIN IDENTIFICACIÓN DEL DESTINATARIO ART. 6.1.D) RD 1619/2012\n* R1: FACTURA RECTIFICATIVA\t(Art 80.1 y 80.2 y error fundado en derecho)\n* R2: FACTURA RECTIFICATIVA (Art. 80.3)\n* R3: FACTURA RECTIFICATIVA\t(Art. 80.4)\n* R4: FACTURA RECTIFICATIVA\t(Resto)\n* R5: FACTURA RECTIFICATIVA\tEN FACTURAS SIMPLIFICADAS\n* F3: FACTURA EMITIDA EN SUSTITUCIÓN DE FACTURAS SIMPLIFICADAS FACTURADAS Y DECLARADAS",
						"title": "VF_ClaveTipoFacturaType"
					},
					"FechaOperacion": {
						"type": "string",
						"description": "Fecha de operación comunicada a VeriFactu cuando la operación se realizó en una fecha distinta de la de la factura (main.date), que es la fecha de expedición. Solo se informa si se indica.",
						"pattern": "\\d{2,2}-\\d{2,2}-\\d{4,4}",
						"minLength": 10,
						"maxLength": 10,
						"title": "VF_fecha"
					},
					"DescripcionOperacion": {
						"type": "string",
						"description": "Restricciones esquema:\n\nxsd-restriction:maxLen 500",
						"maxLength": 500,
						"title": "VF_TextMax500Type"
					},
					"FacturaSimplificadaArt7273": {
						"type": "string",
						"enum": [
							"S",
							"N"
						],
						"title": "VF_SimplificadaCualificadaType"
					},
					"defaultOperacionExenta": {
						"type": "string",
						"enum": [
							"E1",
							"E2",
							"E3",
							"E4",
							"E5",
							"E6",
							"E7",
							"E8"
						],
						"description": "Valor por defecto de OperacionExenta usado en la generación del modelo VeriFactu. Se copia de settings.sales.verifactuDefaultOperacionExenta en caso de utilizarse cuando se genera el modelo."
					}
				}
			},
			"InvoiceMetaBatuzNoSG": {
				"type": "object",
				"title": "InvoiceMetaBatuzNoSG",
				"description": "Información interna relativa a una factura del sistema Batuz generada sin software garante TicketBAI",
				"required": [
					"mustBeSent",
					"sent",
					"batuzAcceptedZuzendu",
					"batuzModelZuzendu",
					"xmlNoSG"
				],
				"properties": {
					"mustBeSent": {
						"type": "boolean",
						"enum": [
							false
						],
						"deprecated": true,
						"description": "Deprecated: campo inerte. El estado de envío de TicketBAI vive en fiscal_records; se conserva por compatibilidad y siempre vale false."
					},
					"sent": {
						"type": "boolean"
					},
					"batuzAcceptedZuzendu": {
						"type": "boolean"
					},
					"batuzModelZuzendu": {
						"type": "object",
						"title": "XmlBatuzModelAlta",
						"description": "Modelo interno del contenido del XML de alta en Batuz para correcciones sin Software Garante (Aplica en Bizkaia)",
						"additionalProperties": true
					},
					"xmlNoSG": {
						"type": "string",
						"description": "Contenido del XML de alta de Batuz para una factura emitida sin Software Garante"
					}
				}
			},
			"InvoiceMetaTicketbai": {
				"type": "object",
				"title": "InvoiceMetaTicketbai",
				"description": "Información interna relativa a TicketBAI",
				"required": [
					"identificador",
					"ordenEncadenamiento",
					"diputacionForal",
					"mustBeSent",
					"sent",
					"xmlModel",
					"xml",
					"encadenamientoFactura"
				],
				"properties": {
					"identificador": {
						"type": "string"
					},
					"ordenEncadenamiento": {
						"type": "integer",
						"minimum": 0
					},
					"diputacionForal": {
						"type": "string",
						"enum": [
							"Araba",
							"Bizkaia",
							"Gipuzkoa"
						]
					},
					"mustBeSent": {
						"type": "boolean",
						"deprecated": true,
						"description": "Deprecated: campo inerte. El estado de envío de TicketBAI vive en fiscal_records; se conserva por compatibilidad y siempre vale false."
					},
					"sent": {
						"type": "boolean"
					},
					"batuzAccepted": {
						"type": "boolean"
					},
					"batuzAcceptedWithErrors": {
						"type": "boolean",
						"enum": [
							true
						]
					},
					"batuzAcceptedZuzendu": {
						"type": "boolean"
					},
					"xmlModel": {
						"type": "object",
						"title": "XmlModelAlta",
						"description": "Modelo interno del contenido del XML de alta de TicketBAI (Aplica en Araba, Bizkaia y Gipuzkoa)",
						"additionalProperties": true
					},
					"batuzModel": {
						"type": "object",
						"title": "XmlBatuzModelAlta",
						"description": "Modelo interno del contenido del XML de alta en Batuz (Aplica en Bizkaia)",
						"additionalProperties": true
					},
					"batuzModelZuzendu": {
						"type": "object",
						"title": "XmlBatuzModelAlta",
						"description": "Modelo interno del contenido del XML de alta en Batuz para correcciones sin Software Garante (Aplica en Bizkaia)",
						"additionalProperties": true
					},
					"xml": {
						"type": "string",
						"description": "Contenido del XML de alta de TicketBAI"
					},
					"xmlNoSG": {
						"type": "string",
						"description": "Contenido del XML de alta de Batuz para una factura emitida sin Software Garante"
					},
					"qrUrl": {
						"type": "string"
					},
					"qr": {
						"type": "string"
					},
					"encadenamientoFactura": {
						"type": "object",
						"title": "EncadenamientoFactura",
						"required": [
							"NumFacturaAnterior",
							"FechaExpedicionFacturaAnterior",
							"SignatureValueFirmaFacturaAnterior"
						],
						"additionalProperties": false,
						"properties": {
							"SerieFacturaAnterior": {
								"type": "string"
							},
							"NumFacturaAnterior": {
								"type": "string"
							},
							"FechaExpedicionFacturaAnterior": {
								"type": "string"
							},
							"SignatureValueFirmaFacturaAnterior": {
								"type": "string"
							}
						}
					},
					"voided": {
						"type": "object",
						"title": "VoidedInvoice",
						"description": "Información de TicketBAI relativa a la anulación de la factura",
						"additionalProperties": false,
						"required": [
							"mustBeSent",
							"sent",
							"xmlModel",
							"xml"
						],
						"properties": {
							"mustBeSent": {
								"type": "boolean",
								"deprecated": true,
								"description": "Deprecated: campo inerte. El estado de envío de TicketBAI vive en fiscal_records; se conserva por compatibilidad y siempre vale false."
							},
							"sent": {
								"type": "boolean"
							},
							"xmlModel": {
								"type": "object",
								"title": "XmlModelAnulacion",
								"description": "Modelo interno del contenido del XML de anulación de TicketBAI (Aplica en Araba, Bizkaia y Gipuzkoa)",
								"additionalProperties": true
							},
							"batuzModel": {
								"type": "object",
								"title": "XmlBatuzModelAnulacion",
								"description": "Modelo interno del contenido del XML de anulación en Batuz (Aplica en Bizkaia)",
								"additionalProperties": true
							},
							"xml": {
								"type": "string",
								"description": "Contenido del XML de anulación de TicketBAI"
							}
						}
					},
					"zuzenduAlta": {
						"type": "object",
						"title": "ZuzenduAlta",
						"description": "Información de TicketBAI relativa a la modificación/subsanación de la factura mediante el servicio Zuzendu",
						"additionalProperties": false,
						"required": [
							"xmlModel",
							"xml"
						],
						"properties": {
							"xmlModel": {
								"type": "object",
								"title": "XmlModelAlta",
								"description": "Modelo interno del contenido del XML de alta Zuzendu de TicketBAI",
								"additionalProperties": true
							},
							"xml": {
								"type": "string",
								"description": "Contenido del XML de alta Zuzendu de TicketBAI"
							}
						}
					}
				}
			},
			"InvoiceMetaVerifactu": {
				"type": "object",
				"title": "InvoiceMetaVerifactu",
				"description": "Información interna autogenerada relativa a VeriFactu",
				"additionalProperties": false,
				"properties": {
					"registroAlta": {
						"type": "object",
						"additionalProperties": true
					},
					"registroAltaXml": {
						"type": "string"
					},
					"registroAnulacion": {
						"type": "object",
						"additionalProperties": true
					},
					"registroAnulacionXml": {
						"type": "string"
					},
					"mode": {
						"$ref": "#/components/schemas/InvoiceMetaVerifactuMode"
					},
					"modeAnulacion": {
						"$ref": "#/components/schemas/InvoiceMetaVerifactuMode"
					},
					"qrUrl": {
						"type": "string"
					},
					"qr": {
						"type": "string"
					}
				}
			},
			"InvoiceMetaVerifactuMode": {
				"type": "string",
				"title": "InvoiceMetaVerifactuMode",
				"enum": [
					"mode_verifactu",
					"mode_no_verifactu"
				]
			},
			"InvoicePaymentsWrite": {
				"type": "array",
				"title": "InvoicePaymentsWrite",
				"description": "Permite crear un pago para una factura.\n\nSe pueden crear múltiples pagos e indicar el importe individual para cada uno de ellos.\n\nSi no se indica el importe (amount) se considera que con ese pago se quiere saldar todo el importe pendiente de la factura, dentro del array solo puede haber un pago sin importe y debe estar en la última posición del array",
				"items": {
					"type": "object",
					"title": "InvoicePaymentWrite",
					"description": "Nuevo pago de una factura.",
					"required": [
						"bank"
					],
					"properties": {
						"date": {
							"type": "string",
							"format": "date",
							"description": "Fecha en la que contabilizar el pago, si no se indica se usa la fecha de la factura cuando se crea una factura o la fecha actual cuando se actualiza"
						},
						"bank": {
							"type": "string",
							"description": "ID del banco en el que se anota el pago"
						},
						"amount": {
							"type": "number",
							"description": "Importe del pago en la moneda original de la factura. Si no se indica se saldará todo el importe pendiente de la factura"
						},
						"companyCurrencyAmount": {
							"type": "number",
							"description": "Importe a contabilizar en euros, puede indicarse solo cuando la moneda de la factura sea distinta a euros y se quiera indicar el valor exacto a contabilizar de dicho pago en euros. Si no se indica se aplicará un tipo de cambio de forma automática según la fecha del pago"
						},
						"description": {
							"type": "string",
							"description": "Descripción del cobro. Sustituye al título por defecto (\"Cobro <factura>\"). Visible en la columna \"Descripción\" de Bancos → Movimientos. Útil para almacenar una referencia operativa del cobro real (p. ej. ID de transacción de Mollie/Stripe o referencia de transferencia)."
						},
						"notes": {
							"type": "string",
							"description": "Notas asociadas al cobro. Texto libre adicional consultable desde Bancos → Movimientos. Útil cuando se quiere mantener la descripción auto-generada y registrar aparte una referencia operativa."
						}
					}
				}
			},
			"InvoicePaymentsWriteResponse": {
				"type": "object",
				"title": "InvoicePaymentsWriteResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/Invoice"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "InvoiceRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "InvoiceRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/TaxDefinition"
											}
										]
									}
								}
							},
							"balance": {
								"type": "object",
								"title": "InvoiceBalance",
								"description": "Saldo abierto de la factura.\n\nSe devuelve el saldo contable de la factura, por lo que el importe pendiente de cobrar se muestra como un valor negativo. El valor es negativo porque \"falta\" dinero conabilizado para que la factura esté saldada. El importe se indica en la moneda de la factura en el elemento `currencyBalance` y en la moneda de la contabilidad de la empresa en el elemento `balance`\n\n```\n{\n  \"balance\": {\n    \"balance\": -28.56, \n    \"currency\": \"USD\", \n    \"currencyBalance\": -30.52\n  }\n}\n```\n\nEl ejemplo anterior corresponde a una factura contabilizada en USD que tiene un importe pendiente de 30,52 USD que están contabilizados como 28,56 EUR.\n\nEn general para saber el importe pendiente de cobrar de una factura debe utilizarse por tanto el elemento `currencyBalance` que es el que representa el saldo pendiente en la moneda en la que se ha emitido la factura.\n",
								"required": [
									"balance",
									"currency",
									"currencyBalance"
								],
								"properties": {
									"balance": {
										"type": "number",
										"description": "Saldo pendiente de la factura en EUR"
									},
									"currency": {
										"type": "string",
										"description": "Moneda original del saldo pendiente de la factura (Formato ISO 4217)"
									},
									"currencyBalance": {
										"type": "number",
										"description": "Saldo pendiente de la factura en la moneda de la factura"
									}
								}
							},
							"state": {
								"type": "string",
								"enum": [
									"draft",
									"pending",
									"overdue",
									"paid",
									"overpaid",
									"voided"
								],
								"description": "Estado de la factura.\n\n* draft: Borrador\n* pending: Pendiente de pago (Factura con saldo pendiente que aún no ha alcanzado las fechas de vencimiento previstas)\n* overdue: Vencida (El saldo pendiente actual es superior al esperado según la información de vencimientos)\n* paid: Pagada (Factura con saldo pendiente cero)\n* overpaid: Sobrepagada (Tiene pagos por encima del importe esperado)\n* voided: Anulada"
							},
							"journal": {
								"type": "array",
								"description": "Apuntes contables de `/journal` que afectan al saldo de la factura.\n\nSe devuelve una entrada por cada documento de saldo (cobros, pagos o remesas SEPA), con la misma forma reducida del endpoint `GET /{companyId}/journal?document={id}` pero sin los campos redundantes con el documento padre (`document`, `documentType`, `documentTitle`) ni los opt-in del endpoint `/journal` (`idAccounting`, `tags`).\n\nLos IDs son polimórficos:\n\n* **`tra_<uuid-v4>`** — `transaction` (asiento contable directo). Caso típico cuando el cobro/pago se ha registrado manualmente o vía transferencia convencional anotada en un banco.\n* **`pay_<uuid-v4>`** — `payment` (remesa SEPA). Aparece cuando la operación se ha agrupado en una remesa de adeudos directos o transferencias SEPA.\n\nLa lista incluye **todos** los apuntes que actualmente componen el saldo (no sólo los recién creados en una llamada). El orden es el mismo que devolvería `GET /journal?document={id}`: por fecha, prioridad contable y línea.\n\nLos campos `currency`, `currencyDebit` y `currencyCredit` sólo aparecen si la empresa tiene multicurrency activada y el apunte está en una moneda distinta a la de la contabilidad.",
								"items": {
									"$ref": "#/components/schemas/RelatedJournalEntry"
								}
							}
						}
					},
					"paymentsInfo": {
						"type": "object",
						"properties": {
							"total": {
								"type": "number",
								"description": "Número total de pagos que modifican el saldo de la factura"
							},
							"totalCreated": {
								"type": "number",
								"description": "Número total de pagos creados en esta operación"
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"InvoiceResponse": {
				"type": "object",
				"title": "InvoiceResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/Invoice"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "InvoiceRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "InvoiceRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/TaxDefinition"
											}
										]
									}
								}
							},
							"balance": {
								"type": "object",
								"title": "InvoiceBalance",
								"description": "Saldo abierto de la factura.\n\nSe devuelve el saldo contable de la factura, por lo que el importe pendiente de cobrar se muestra como un valor negativo. El valor es negativo porque \"falta\" dinero conabilizado para que la factura esté saldada. El importe se indica en la moneda de la factura en el elemento `currencyBalance` y en la moneda de la contabilidad de la empresa en el elemento `balance`\n\n```\n{\n  \"balance\": {\n    \"balance\": -28.56, \n    \"currency\": \"USD\", \n    \"currencyBalance\": -30.52\n  }\n}\n```\n\nEl ejemplo anterior corresponde a una factura contabilizada en USD que tiene un importe pendiente de 30,52 USD que están contabilizados como 28,56 EUR.\n\nEn general para saber el importe pendiente de cobrar de una factura debe utilizarse por tanto el elemento `currencyBalance` que es el que representa el saldo pendiente en la moneda en la que se ha emitido la factura.\n",
								"required": [
									"balance",
									"currency",
									"currencyBalance"
								],
								"properties": {
									"balance": {
										"type": "number",
										"description": "Saldo pendiente de la factura en EUR"
									},
									"currency": {
										"type": "string",
										"description": "Moneda original del saldo pendiente de la factura (Formato ISO 4217)"
									},
									"currencyBalance": {
										"type": "number",
										"description": "Saldo pendiente de la factura en la moneda de la factura"
									}
								}
							},
							"state": {
								"type": "string",
								"enum": [
									"draft",
									"pending",
									"overdue",
									"paid",
									"overpaid",
									"voided"
								],
								"description": "Estado de la factura.\n\n* draft: Borrador\n* pending: Pendiente de pago (Factura con saldo pendiente que aún no ha alcanzado las fechas de vencimiento previstas)\n* overdue: Vencida (El saldo pendiente actual es superior al esperado según la información de vencimientos)\n* paid: Pagada (Factura con saldo pendiente cero)\n* overpaid: Sobrepagada (Tiene pagos por encima del importe esperado)\n* voided: Anulada"
							},
							"journal": {
								"type": "array",
								"description": "Apuntes contables de `/journal` que afectan al saldo de la factura.\n\nSe devuelve una entrada por cada documento de saldo (cobros, pagos o remesas SEPA), con la misma forma reducida del endpoint `GET /{companyId}/journal?document={id}` pero sin los campos redundantes con el documento padre (`document`, `documentType`, `documentTitle`) ni los opt-in del endpoint `/journal` (`idAccounting`, `tags`).\n\nLos IDs son polimórficos:\n\n* **`tra_<uuid-v4>`** — `transaction` (asiento contable directo). Caso típico cuando el cobro/pago se ha registrado manualmente o vía transferencia convencional anotada en un banco.\n* **`pay_<uuid-v4>`** — `payment` (remesa SEPA). Aparece cuando la operación se ha agrupado en una remesa de adeudos directos o transferencias SEPA.\n\nLa lista incluye **todos** los apuntes que actualmente componen el saldo (no sólo los recién creados en una llamada). El orden es el mismo que devolvería `GET /journal?document={id}`: por fecha, prioridad contable y línea.\n\nLos campos `currency`, `currencyDebit` y `currencyCredit` sólo aparecen si la empresa tiene multicurrency activada y el apunte está en una moneda distinta a la de la contabilidad.",
								"items": {
									"$ref": "#/components/schemas/RelatedJournalEntry"
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"InvoiceWrite": {
				"type": "object",
				"additionalProperties": false,
				"title": "InvoiceWrite",
				"required": [
					"type",
					"main"
				],
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"invoice"
						]
					},
					"accounting": {
						"$ref": "#/components/schemas/Accounting",
						"readOnly": true
					},
					"books": {
						"$ref": "#/components/schemas/Books",
						"readOnly": true
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/AttachmentWrite"
						},
						"maxItems": 10
					},
					"main": {
						"type": "object",
						"title": "InvoiceMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (cliente) (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"description": "Código postal de la dirección fiscal del contacto",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes de la factura (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"depreciable": {
								"type": "boolean"
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumberWrite"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"emails": {
								"type": "string",
								"description": "Lista de emails separados por comas de los destinatarios a los que se enviará por defecto esta factura"
							},
							"emailsCc": {
								"type": "string",
								"description": "Lista de emails separados por comas de los destinatarios a los que se enviará por defecto en copia visible esta factura"
							},
							"emailsBcc": {
								"type": "string",
								"description": "Lista de emails separados por comas de los destinatarios a los que se enviará por defecto en copia oculta esta factura"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "InvoiceLines",
								"description": "Líneas de la factura",
								"items": {
									"$ref": "#/components/schemas/InvoiceMainLineWrite"
								}
							},
							"manualAccounting": {
								"$ref": "#/components/schemas/InvoiceMainManualAccounting"
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles de la factura",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/SalesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"pendingBeforeAccounting": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"correctedInvoice": {
								"type": "string",
								"description": "ID de la factura rectificada para una factura rectificativa"
							},
							"facturae": {
								"$ref": "#/components/schemas/InvoiceMainFacturae"
							},
							"externalId": {
								"type": "string"
							},
							"installments": {
								"$ref": "#/components/schemas/Installments"
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas de la factura, no serán visibles en el documento impreso"
							},
							"draft": {
								"type": "boolean",
								"description": "Indica si la factura es provisional (true) o definitiva (false). Una factura provisional no tiene número, se puede editar libremente y no tiene efecto contable ni fiscal. Guardarla como definitiva la emite: se le asigna número y, si la empresa tiene VeriFactu o TicketBAI activos y la factura no es externa, se genera el registro fiscal y se envía a la AEAT o a la Diputación Foral en ese mismo momento. Una factura definitiva no vuelve a ser provisional y, con esos sistemas, ya no se puede modificar ni borrar: solo anular, rectificar o, con VeriFactu, subsanar. Si no se indica al crear la factura, se aplica la configuración de la empresa (sales.newInvoiceMode), que puede ser definitiva: indícalo siempre de forma explícita."
							},
							"voided": {
								"type": "boolean",
								"description": "Indica si es una factura anulada. Anular es declarar que la factura no tenía que emitirse: conserva su número y queda visible como anulada. Si la factura tenía que existir pero contiene errores, lo que corresponde es subsanarla (VeriFactu) o emitir una rectificativa. Con VeriFactu o TicketBAI activos, la anulación se comunica a la administración y no se puede revertir; sin ellos, volver a poner voided a false restaura la factura."
							},
							"external": {
								"type": "boolean",
								"description": "Indica que es una factura externa creada fuera del programa. Genera contabilidad e impuestos normalmente, pero NO genera información para VeriFactu ni TicketBAI."
							},
							"corrective": {
								"type": "boolean",
								"description": "Indica si la factura es rectificativa. Fuente de verdad única para determinar si una factura es rectificativa."
							},
							"substitution": {
								"type": "boolean",
								"description": "Indica que es una factura que sustituye a otras facturas simplificadas (corresponde a F3 en VeriFactu). No genera contabilidad, solo genera información para el modelo 347."
							},
							"substitutedInvoices": {
								"type": "array",
								"items": {
									"type": "string"
								},
								"description": "Array de UUIDs de facturas simplificadas que esta factura sustituye. Solo tiene sentido cuando substitution === true."
							},
							"taxCalculationMode": {
								"type": "string",
								"enum": [
									"total",
									"lines"
								]
							},
							"verifactu": {
								"$ref": "#/components/schemas/InvoiceMainVerifactu"
							},
							"ticketbai": {
								"$ref": "#/components/schemas/InvoiceMainTicketbai"
							},
							"simplified": {
								"type": "boolean",
								"description": "Indica si la factura es simplificada. Una factura es simplificada cuando no identifica al destinatario con datos fiscales completos."
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							},
							"owner": {
								"type": "string",
								"description": "Usuario responsable de la factura. Se usa para limitar la visibilidad a documentos asignados."
							}
						},
						"required": [
							"docNumber",
							"lines"
						]
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"meta": {
						"type": "object",
						"title": "InvoiceMeta",
						"description": "Metadatos internos de la factura",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							},
							"expeditionTimestamp": {
								"type": "string",
								"description": "Fecha y hora de expedición de la factura en formato ISO 8601 GMT (ej: 2025-12-05T10:00:02.893Z). Se inicializa automáticamente al guardar la factura por primera vez como definitiva."
							},
							"verifactu": {
								"$ref": "#/components/schemas/InvoiceMetaVerifactu"
							},
							"ticketbai": {
								"oneOf": [
									{
										"$ref": "#/components/schemas/InvoiceMetaTicketbai"
									},
									{
										"$ref": "#/components/schemas/InvoiceMetaBatuzNoSG"
									}
								]
							}
						},
						"readOnly": true
					}
				},
				"description": "Versión simplificada de la factura con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"JournalPriority": {
				"type": "integer",
				"minimum": 1,
				"maximum": 999,
				"title": "JournalPriority",
				"description": "Orden del asiento en el diario según su tipo: \n\n* 1: Inicio de contabilidad/Apertura periodo\n* 2: Contabilidad ficticia generada por un documento con fecha previa al inicio de contabilidad en el programa\n* 3: Asiento de traspaso de beneficios en la apertura\n* 100: Asiento estándar\n* 970: Amortizaciones\n* 980: Regularización moneda extranjera\n* 990: Cierre grupos 6 y 7\n* 999: Cierre del periodo"
			},
			"ModificationDate": {
				"type": "string",
				"title": "ModificationDate",
				"description": "Fecha de la última modificación del objeto en el sistema (Formato ISO 8601 con representación de tiempo en UTC: \"YYYY-MM-DDTHH:mm:ss.sssZ\")",
				"format": "date-time"
			},
			"Pagination": {
				"type": "object",
				"title": "Pagination",
				"description": "Información de paginación de la consulta realizada",
				"additionalProperties": false,
				"required": [
					"limit",
					"offset",
					"total"
				],
				"properties": {
					"limit": {
						"type": "integer",
						"minimum": 1,
						"maximum": 500
					},
					"offset": {
						"type": "integer",
						"minimum": 0
					},
					"total": {
						"type": "integer",
						"minimum": 0
					}
				}
			},
			"PaymentMethod": {
				"type": "object",
				"additionalProperties": false,
				"title": "PaymentMethod",
				"required": [
					"uuid",
					"type",
					"main"
				],
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"paymentMethod"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"main": {
						"type": "object",
						"title": "PaymentMethodMain",
						"additionalProperties": false,
						"required": [
							"title",
							"subtype",
							"details"
						],
						"properties": {
							"title": {
								"type": "string",
								"description": "Nombre del método de pago para diferenciarlo en los listados"
							},
							"direction": {
								"type": "string",
								"enum": [
									"send",
									"receive"
								],
								"description": "Indica si es un método de pago para hacer pagos `send` o para recibirlos `receive`"
							},
							"bank": {
								"type": "string",
								"description": "ID del banco asociado a este método de pago. En los métodos manuales es el banco en el que se registra el cobro al marcar un documento como cobrado; en los métodos de cobro online (`online`) es el banco pasarela y es obligatorio"
							},
							"contact": {
								"type": "string",
								"description": "ID del contacto al que está asociado este método de pago",
								"nullable": true
							},
							"subtype": {
								"type": "string",
								"enum": [
									"manual",
									"sepaDirectDebit",
									"sepaCreditTransfer",
									"online"
								],
								"description": "Tipo del método de pago:\n\nmanual: Método manual, es solo una descripción para indicarlo en los documentos. No se puede indicar un contacto\nsepaDirectDebit: Mándato para cobros mediante recibo domiciliado. El contacto es obligatorio.\nsepaCreditTransfer: Mandato para pagos mediante transferencia bancaria. El contacto es obligatorio\nonline: Cobro online a través de una pasarela de pago (Stripe). Lo crea FacturaDirecta automáticamente al conectar la cuenta de cobro: no se puede crear ni borrar a mano y solo admite cambiar el título. No se puede indicar un contacto. Las facturas con este método de pago se pueden pagar online desde el portal de cliente"
							},
							"details": {
								"title": "PaymentMethodDetails",
								"oneOf": [
									{
										"type": "object",
										"title": "Manual",
										"description": "Método de pago manual",
										"additionalProperties": false,
										"properties": {}
									},
									{
										"type": "object",
										"title": "SepaDirectDebit",
										"description": "Detalles del método de pago para cobros mediante recibo domiciliado (Mandato)",
										"additionalProperties": false,
										"required": [
											"id",
											"signatureDate",
											"instrument",
											"recurrent",
											"bic",
											"iban4"
										],
										"properties": {
											"id": {
												"type": "string",
												"description": "Identificador del mandato"
											},
											"signatureDate": {
												"type": "string",
												"format": "date",
												"description": "Fecha de firma del mandato",
												"nullable": true
											},
											"instrument": {
												"type": "string",
												"enum": [
													"B2B",
													"CORE"
												],
												"description": "Esquema de adeudo: B2B o CORE"
											},
											"recurrent": {
												"type": "boolean",
												"description": "Indicador de mandato para cobros recurrentes"
											},
											"iban": {
												"type": "string",
												"minLength": 1,
												"description": "Código IBAN de la cuenta en la que se realizarán los cargos"
											},
											"bic": {
												"type": "string",
												"description": "Código SWFIT/BIC de la entidad bancaria a la que pertenece la cuenta en la que se realizarán los cargos. Necesario solo para cobros internacionales"
											},
											"iban4": {
												"type": "string",
												"minLength": 1,
												"description": "Últimos 4 dígitos del IBAN de la cuenta en la que se realizarán los cargos"
											}
										}
									},
									{
										"type": "object",
										"title": "SepaCreditTransfer",
										"additionalProperties": false,
										"required": [
											"bic",
											"iban4"
										],
										"properties": {
											"iban": {
												"type": "string",
												"minLength": 1,
												"description": "Código IBAN de la cuenta a la que se harán los pagos"
											},
											"bic": {
												"type": "string",
												"description": "Código SWFIT/BIC de la entidad bancaria a la que pertenece la cuenta a la que se harán los pagos. Necesario solo para cobros internacionales"
											},
											"iban4": {
												"type": "string",
												"minLength": 1,
												"description": "Últimos 4 dígitos del IBAN de la cuenta a la que hacer los pagos"
											}
										}
									},
									{
										"type": "object",
										"title": "Online",
										"description": "Detalles del método de cobro online: la pasarela (o pasarelas) por la que se puede cobrar. Gestionado por FacturaDirecta",
										"additionalProperties": false,
										"required": [
											"gateways",
											"managed"
										],
										"properties": {
											"gateways": {
												"type": "array",
												"minItems": 1,
												"description": "Bancos pasarela por los que se puede cobrar online. El proveedor se deduce del banco (hoy solo cuentas de Stripe). Actualmente se admite exactamente uno, que coincide con `main.bank`",
												"items": {
													"type": "object",
													"additionalProperties": false,
													"required": [
														"bank"
													],
													"properties": {
														"bank": {
															"type": "string",
															"description": "ID del banco pasarela (cuenta de Stripe conectada)"
														}
													}
												}
											},
											"managed": {
												"type": "boolean",
												"enum": [
													true
												],
												"description": "Siempre `true`: todos los métodos de cobro online los crea y gestiona FacturaDirecta al conectar la cuenta de cobro. No se pueden borrar directamente (se borran con el banco) y solo admiten cambiar el título; cualquier otro cambio se rechaza"
											}
										}
									}
								]
							}
						}
					}
				}
			},
			"PaymentMethodResponse": {
				"type": "object",
				"title": "PaymentMethodResponse",
				"required": [
					"content",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/PaymentMethod"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					}
				}
			},
			"PaymentMethodWrite": {
				"type": "object",
				"additionalProperties": false,
				"title": "PaymentMethodWrite",
				"required": [
					"type",
					"main"
				],
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"paymentMethod"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"main": {
						"type": "object",
						"title": "PaymentMethodMain",
						"additionalProperties": false,
						"required": [
							"title",
							"subtype",
							"details"
						],
						"properties": {
							"title": {
								"type": "string",
								"description": "Nombre del método de pago para diferenciarlo en los listados"
							},
							"direction": {
								"type": "string",
								"enum": [
									"send",
									"receive"
								],
								"description": "Indica si es un método de pago para hacer pagos `send` o para recibirlos `receive`"
							},
							"bank": {
								"type": "string",
								"description": "ID del banco asociado a este método de pago. En los métodos manuales es el banco en el que se registra el cobro al marcar un documento como cobrado; en los métodos de cobro online (`online`) es el banco pasarela y es obligatorio"
							},
							"contact": {
								"type": "string",
								"description": "ID del contacto al que está asociado este método de pago",
								"nullable": true
							},
							"subtype": {
								"type": "string",
								"enum": [
									"manual",
									"sepaDirectDebit",
									"sepaCreditTransfer",
									"online"
								],
								"description": "Tipo del método de pago:\n\nmanual: Método manual, es solo una descripción para indicarlo en los documentos. No se puede indicar un contacto\nsepaDirectDebit: Mándato para cobros mediante recibo domiciliado. El contacto es obligatorio.\nsepaCreditTransfer: Mandato para pagos mediante transferencia bancaria. El contacto es obligatorio\nonline: Cobro online a través de una pasarela de pago (Stripe). Lo crea FacturaDirecta automáticamente al conectar la cuenta de cobro: no se puede crear ni borrar a mano y solo admite cambiar el título. No se puede indicar un contacto. Las facturas con este método de pago se pueden pagar online desde el portal de cliente"
							},
							"details": {
								"title": "PaymentMethodDetails",
								"oneOf": [
									{
										"type": "object",
										"title": "Manual",
										"description": "Método de pago manual",
										"additionalProperties": false,
										"properties": {}
									},
									{
										"type": "object",
										"title": "SepaDirectDebit",
										"description": "Detalles del método de pago para cobros mediante recibo domiciliado (Mandato)",
										"additionalProperties": false,
										"required": [
											"id",
											"signatureDate",
											"instrument",
											"recurrent",
											"iban"
										],
										"properties": {
											"id": {
												"type": "string",
												"description": "Identificador del mandato"
											},
											"signatureDate": {
												"type": "string",
												"format": "date",
												"description": "Fecha de firma del mandato",
												"nullable": true
											},
											"instrument": {
												"type": "string",
												"enum": [
													"B2B",
													"CORE"
												],
												"description": "Esquema de adeudo: B2B o CORE"
											},
											"recurrent": {
												"type": "boolean",
												"description": "Indicador de mandato para cobros recurrentes"
											},
											"iban": {
												"type": "string",
												"minLength": 1,
												"description": "Código IBAN de la cuenta en la que se realizarán los cargos"
											},
											"bic": {
												"type": "string",
												"description": "Código SWFIT/BIC de la entidad bancaria a la que pertenece la cuenta en la que se realizarán los cargos. Necesario solo para cobros internacionales"
											},
											"iban4": {
												"type": "string",
												"minLength": 1,
												"description": "Últimos 4 dígitos del IBAN de la cuenta en la que se realizarán los cargos"
											}
										}
									},
									{
										"type": "object",
										"title": "SepaCreditTransfer",
										"additionalProperties": false,
										"required": [
											"iban"
										],
										"properties": {
											"iban": {
												"type": "string",
												"minLength": 1,
												"description": "Código IBAN de la cuenta a la que se harán los pagos"
											},
											"bic": {
												"type": "string",
												"description": "Código SWFIT/BIC de la entidad bancaria a la que pertenece la cuenta a la que se harán los pagos. Necesario solo para cobros internacionales"
											},
											"iban4": {
												"type": "string",
												"minLength": 1,
												"description": "Últimos 4 dígitos del IBAN de la cuenta a la que hacer los pagos"
											}
										}
									},
									{
										"type": "object",
										"title": "Online",
										"description": "Detalles del método de cobro online: la pasarela (o pasarelas) por la que se puede cobrar. Gestionado por FacturaDirecta",
										"additionalProperties": false,
										"required": [
											"gateways",
											"managed"
										],
										"properties": {
											"gateways": {
												"type": "array",
												"minItems": 1,
												"description": "Bancos pasarela por los que se puede cobrar online. El proveedor se deduce del banco (hoy solo cuentas de Stripe). Actualmente se admite exactamente uno, que coincide con `main.bank`",
												"items": {
													"type": "object",
													"additionalProperties": false,
													"required": [
														"bank"
													],
													"properties": {
														"bank": {
															"type": "string",
															"description": "ID del banco pasarela (cuenta de Stripe conectada)"
														}
													}
												}
											},
											"managed": {
												"type": "boolean",
												"enum": [
													true
												],
												"description": "Siempre `true`: todos los métodos de cobro online los crea y gestiona FacturaDirecta al conectar la cuenta de cobro. No se pueden borrar directamente (se borran con el banco) y solo admiten cambiar el título; cualquier otro cambio se rechaza"
											}
										}
									}
								]
							}
						}
					}
				},
				"description": "Versión simplificada del método de pago con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"Payroll": {
				"type": "object",
				"title": "Payroll",
				"required": [
					"uuid",
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"payroll"
						]
					},
					"accounting": {
						"$ref": "#/components/schemas/Accounting",
						"readOnly": true
					},
					"books": {
						"$ref": "#/components/schemas/Books",
						"readOnly": true
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"main": {
						"type": "object",
						"title": "PayrollMain",
						"required": [
							"account",
							"currency",
							"modelo190",
							"lines",
							"contact",
							"date",
							"dueDate"
						],
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"contact": {
								"type": "string",
								"description": "Empleado para el que se ha emitido esta nómina"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (empleado) (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"description": "Código postal de la dirección fiscal del contacto (empleado)",
								"nullable": true
							},
							"account": {
								"description": "Número de cuenta contable en la que anotar las remuneraciones pendientes asociadas a la nómina (Habitualmente 465000)",
								"allOf": [
									{
										"$ref": "#/components/schemas/AccountCode"
									}
								]
							},
							"currency": {
								"type": "string",
								"description": "Moneda orignal de la nómina. (Actualmente limitado a EUR)"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 1,
								"maximum": 1,
								"description": "Tipo de cambio de la moneda original respecto a la moneda de la empresa. (Siempre 1 para nóminas)"
							},
							"lines": {
								"type": "array",
								"title": "PayrollLines",
								"description": "Líneas de la nómina",
								"minItems": 1,
								"items": {
									"$ref": "#/components/schemas/PayrollLine"
								}
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total devengado en la moneda original de la nómina"
							},
							"total": {
								"type": "number",
								"description": "Importe líquido a percibir en la moneda original de la nómina"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total devengado contabilizado en la moneda de contabilidad la empresa"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe líquido a percibir en la moneda de contabilidad la empresa"
							},
							"pendingBeforeAccounting": {
								"type": "number",
								"description": "Importe pendiente de pagar de una nómina que se registra en el programa con fecha anterior a la del inicio de contabilidad de la empresa en el programa.\n\nSolo puede utilizarse en nóminas con fecha anterior a la fecha de inicio contable en el programa."
							},
							"notes": {
								"type": "string",
								"description": "Notas internas de la nómina"
							},
							"date": {
								"type": "string",
								"format": "date",
								"description": "Fecha de contabilización de la nómina en formato yyyy-mm-dd"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha de vencimiento de la nómina en formato yyyy-mm-dd"
							},
							"paymentMethod": {
								"type": "string",
								"description": "ID del método de pago que se utilizará para saldar esta nómina",
								"nullable": true
							},
							"task": {
								"type": "string",
								"description": "Identificador del documento externo subido que se ha utilizado como origen de esta nómina en un proceso de conversión realizado en el programa."
							},
							"modelo190": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"clavePercepcion"
								],
								"properties": {
									"clavePercepcion": {
										"type": "string",
										"minLength": 1,
										"maxLength": 1,
										"pattern": "[A-Z]{1}"
									},
									"subclavePercepcion": {
										"type": "string",
										"minLength": 2,
										"maxLength": 2,
										"pattern": "[0-9]{2}"
									}
								}
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							}
						}
					},
					"meta": {
						"type": "object",
						"title": "PayrollMeta",
						"description": "Metadatos internos de la nómina",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					}
				}
			},
			"PayrollLine": {
				"type": "object",
				"title": "PayrollLine",
				"additionalProperties": false,
				"required": [
					"type",
					"lineTotal",
					"account"
				],
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"debit",
							"credit",
							"irpf_employee",
							"irpf_employee_kind",
							"irpf_employee_kind_passedon",
							"ss_employee",
							"ss_company"
						],
						"description": "Indica el tipo de anotación en la nómina con los siguientes valores:\n\n* debit: Salario\n* credit: Deducción\n* irpf_employee: Retención de IRPF (Percepciones dinerarias)\n* irpf_employee_kind: Retención de IRPF (Percepciones en especie)\n* ss_employee: Aportaciones Seguridad Social a cargo del trabajador\n* ss_company: Aportaciones Seguridad Social a cargo de la empresa"
					},
					"debitType": {
						"type": "string",
						"enum": [
							"salary",
							"nonSalary"
						],
						"description": "Solo para líneas con type=\"debit\", indica si la percepción es salarial o no salarial "
					},
					"label": {
						"type": "string",
						"description": "Etiqueta interna descriptiva del tipo de línea"
					},
					"text": {
						"type": "string",
						"description": "Etiqueta de libre uso del tipo de línea"
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"base": {
						"type": "number",
						"description": "Base imponible de la línea"
					},
					"lineTotal": {
						"type": "number",
						"description": "Importe aplicado en la línea"
					}
				}
			},
			"PayrollPaymentsWrite": {
				"type": "array",
				"title": "PayrollPaymentsWrite",
				"description": "Permite crear un pago para una nómina.\n\nSe pueden crear múltiples pagos e indicar el importe individual para cada uno de ellos.\n\nSi no se indica el importe (amount) se considera que con ese pago se quiere saldar todo el importe pendiente de la mónima, dentro del array solo puede haber un pago sin importe y debe estar en la última posición del array",
				"items": {
					"type": "object",
					"title": "PayrollPaymentWrite",
					"description": "Nuevo pago de una nómina.",
					"required": [
						"bank"
					],
					"properties": {
						"date": {
							"type": "string",
							"format": "date",
							"description": "Fecha en la que contabilizar el pago, si no se indica se usa la fecha de la nómina cuando se crea una nómina o la fecha actual cuando se actualiza"
						},
						"bank": {
							"type": "string",
							"description": "ID del banco en el que se anota el pago"
						},
						"amount": {
							"type": "number",
							"description": "Importe del pago en la moneda original de la nómina. Si no se indica se saldará todo el importe pendiente de la nómina"
						},
						"companyCurrencyAmount": {
							"type": "number",
							"description": "Importe a contabilizar en euros, puede indicarse solo cuando la moneda de la nómina sea distinta a euros y se quiera indicar el valor exacto a contabilizar de dicho pago en euros. Si no se indica se aplicará un tipo de cambio de forma automática según la fecha del pago"
						},
						"description": {
							"type": "string",
							"description": "Descripción del pago. Sustituye al título por defecto (\"Pago <nómina>\"). Visible en la columna \"Descripción\" de Bancos → Movimientos. Útil para almacenar una referencia operativa del pago real (p. ej. referencia de transferencia)."
						},
						"notes": {
							"type": "string",
							"description": "Notas asociadas al pago. Texto libre adicional consultable desde Bancos → Movimientos. Útil cuando se quiere mantener la descripción auto-generada y registrar aparte una referencia operativa."
						}
					}
				}
			},
			"PayrollPaymentsWriteResponse": {
				"type": "object",
				"title": "PayrollPaymentsWriteResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/Payroll"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "PayrollRelated",
						"additionalProperties": false,
						"properties": {
							"balance": {
								"type": "object",
								"title": "PayrollBalance",
								"description": "Saldo abierto de la nómina.\n\nSe devuelve el saldo contable de la nómina, el importe pendiente de pagar se muestra como un valor positivo. El importe se indica en la moneda de la nómina en el elemento `currencyBalance` y en la moneda de la contabilidad de la empresa en el elemento `balance`\n\n```\n{\n  \"balance\": {\n    \"balance\": 28.56,\n    \"currency\": \"EUR\",\n    \"currencyBalance\": 28.56\n  }\n}\n```\n",
								"required": [
									"balance",
									"currency",
									"currencyBalance"
								],
								"properties": {
									"balance": {
										"type": "number",
										"description": "Saldo pendiente de la nómina en EUR"
									},
									"currency": {
										"type": "string",
										"description": "Moneda original del saldo pendiente de la nómina (Formato ISO 4217). Actualmente restringido a EUR"
									},
									"currencyBalance": {
										"type": "number",
										"description": "Saldo pendiente de la nómina en la moneda de la nómina"
									}
								}
							},
							"state": {
								"type": "string",
								"enum": [
									"pending",
									"overdue",
									"paid",
									"overpaid"
								],
								"description": "Estado de la nómina.\n\n* pending: Pendiente de pago (Nómina con saldo pendiente que aún no ha alcanzado las fechas de vencimiento previstas)\n* overdue: Vencida (El saldo pendiente actual es superior al esperado según la información de vencimientos)\n* paid: Pagada (Nómina con saldo pendiente cero)\n* overpaid: Sobrepagada (Tiene pagos por encima del importe esperado)"
							},
							"journal": {
								"type": "array",
								"description": "Apuntes contables de `/journal` que afectan al saldo de la nómina.\n\nSe devuelve una entrada por cada documento de saldo (cobros, pagos o remesas SEPA), con la misma forma reducida del endpoint `GET /{companyId}/journal?document={id}` pero sin los campos redundantes con el documento padre (`document`, `documentType`, `documentTitle`) ni los opt-in del endpoint `/journal` (`idAccounting`, `tags`).\n\nLos IDs son polimórficos:\n\n* **`tra_<uuid-v4>`** — `transaction` (asiento contable directo). Caso típico cuando el cobro/pago se ha registrado manualmente o vía transferencia convencional anotada en un banco.\n* **`pay_<uuid-v4>`** — `payment` (remesa SEPA). Aparece cuando la operación se ha agrupado en una remesa de adeudos directos o transferencias SEPA.\n\nLa lista incluye **todos** los apuntes que actualmente componen el saldo (no sólo los recién creados en una llamada). El orden es el mismo que devolvería `GET /journal?document={id}`: por fecha, prioridad contable y línea.\n\nLos campos `currency`, `currencyDebit` y `currencyCredit` sólo aparecen si la empresa tiene multicurrency activada y el apunte está en una moneda distinta a la de la contabilidad.",
								"items": {
									"$ref": "#/components/schemas/RelatedJournalEntry"
								}
							}
						}
					},
					"paymentsInfo": {
						"type": "object",
						"properties": {
							"total": {
								"type": "number",
								"description": "Número total de pagos que modifican el saldo de la nómina"
							},
							"totalCreated": {
								"type": "number",
								"description": "Número total de pagos creados en esta operación"
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"PayrollResponse": {
				"type": "object",
				"title": "PayrollResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/Payroll"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "PayrollRelated",
						"additionalProperties": false,
						"properties": {
							"balance": {
								"type": "object",
								"title": "PayrollBalance",
								"description": "Saldo abierto de la nómina.\n\nSe devuelve el saldo contable de la nómina, el importe pendiente de pagar se muestra como un valor positivo. El importe se indica en la moneda de la nómina en el elemento `currencyBalance` y en la moneda de la contabilidad de la empresa en el elemento `balance`\n\n```\n{\n  \"balance\": {\n    \"balance\": 28.56,\n    \"currency\": \"EUR\",\n    \"currencyBalance\": 28.56\n  }\n}\n```\n",
								"required": [
									"balance",
									"currency",
									"currencyBalance"
								],
								"properties": {
									"balance": {
										"type": "number",
										"description": "Saldo pendiente de la nómina en EUR"
									},
									"currency": {
										"type": "string",
										"description": "Moneda original del saldo pendiente de la nómina (Formato ISO 4217). Actualmente restringido a EUR"
									},
									"currencyBalance": {
										"type": "number",
										"description": "Saldo pendiente de la nómina en la moneda de la nómina"
									}
								}
							},
							"state": {
								"type": "string",
								"enum": [
									"pending",
									"overdue",
									"paid",
									"overpaid"
								],
								"description": "Estado de la nómina.\n\n* pending: Pendiente de pago (Nómina con saldo pendiente que aún no ha alcanzado las fechas de vencimiento previstas)\n* overdue: Vencida (El saldo pendiente actual es superior al esperado según la información de vencimientos)\n* paid: Pagada (Nómina con saldo pendiente cero)\n* overpaid: Sobrepagada (Tiene pagos por encima del importe esperado)"
							},
							"journal": {
								"type": "array",
								"description": "Apuntes contables de `/journal` que afectan al saldo de la nómina.\n\nSe devuelve una entrada por cada documento de saldo (cobros, pagos o remesas SEPA), con la misma forma reducida del endpoint `GET /{companyId}/journal?document={id}` pero sin los campos redundantes con el documento padre (`document`, `documentType`, `documentTitle`) ni los opt-in del endpoint `/journal` (`idAccounting`, `tags`).\n\nLos IDs son polimórficos:\n\n* **`tra_<uuid-v4>`** — `transaction` (asiento contable directo). Caso típico cuando el cobro/pago se ha registrado manualmente o vía transferencia convencional anotada en un banco.\n* **`pay_<uuid-v4>`** — `payment` (remesa SEPA). Aparece cuando la operación se ha agrupado en una remesa de adeudos directos o transferencias SEPA.\n\nLa lista incluye **todos** los apuntes que actualmente componen el saldo (no sólo los recién creados en una llamada). El orden es el mismo que devolvería `GET /journal?document={id}`: por fecha, prioridad contable y línea.\n\nLos campos `currency`, `currencyDebit` y `currencyCredit` sólo aparecen si la empresa tiene multicurrency activada y el apunte está en una moneda distinta a la de la contabilidad.",
								"items": {
									"$ref": "#/components/schemas/RelatedJournalEntry"
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"PayrollWrite": {
				"type": "object",
				"title": "PayrollWrite",
				"required": [
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"payroll"
						]
					},
					"accounting": {
						"$ref": "#/components/schemas/Accounting",
						"readOnly": true
					},
					"books": {
						"$ref": "#/components/schemas/Books",
						"readOnly": true
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/AttachmentWrite"
						},
						"maxItems": 10
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"main": {
						"type": "object",
						"title": "PayrollMain",
						"required": [
							"modelo190",
							"lines",
							"contact"
						],
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"contact": {
								"type": "string",
								"description": "Empleado para el que se ha emitido esta nómina"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del contacto (empleado) (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"description": "Código postal de la dirección fiscal del contacto (empleado)",
								"nullable": true
							},
							"account": {
								"description": "Número de cuenta contable en la que anotar las remuneraciones pendientes asociadas a la nómina (Habitualmente 465000)",
								"allOf": [
									{
										"$ref": "#/components/schemas/AccountCode"
									}
								]
							},
							"currency": {
								"type": "string",
								"description": "Moneda orignal de la nómina. (Actualmente limitado a EUR)"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 1,
								"maximum": 1,
								"description": "Tipo de cambio de la moneda original respecto a la moneda de la empresa. (Siempre 1 para nóminas)"
							},
							"lines": {
								"type": "array",
								"title": "PayrollLines",
								"description": "Líneas de la nómina",
								"minItems": 1,
								"items": {
									"$ref": "#/components/schemas/PayrollLine"
								}
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total devengado en la moneda original de la nómina"
							},
							"total": {
								"type": "number",
								"description": "Importe líquido a percibir en la moneda original de la nómina"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total devengado contabilizado en la moneda de contabilidad la empresa"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe líquido a percibir en la moneda de contabilidad la empresa"
							},
							"pendingBeforeAccounting": {
								"type": "number",
								"description": "Importe pendiente de pagar de una nómina que se registra en el programa con fecha anterior a la del inicio de contabilidad de la empresa en el programa.\n\nSolo puede utilizarse en nóminas con fecha anterior a la fecha de inicio contable en el programa."
							},
							"notes": {
								"type": "string",
								"description": "Notas internas de la nómina"
							},
							"date": {
								"type": "string",
								"format": "date",
								"description": "Fecha de contabilización de la nómina en formato yyyy-mm-dd"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha de vencimiento de la nómina en formato yyyy-mm-dd"
							},
							"paymentMethod": {
								"type": "string",
								"description": "ID del método de pago que se utilizará para saldar esta nómina",
								"nullable": true
							},
							"task": {
								"type": "string",
								"description": "Identificador del documento externo subido que se ha utilizado como origen de esta nómina en un proceso de conversión realizado en el programa."
							},
							"modelo190": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"clavePercepcion"
								],
								"properties": {
									"clavePercepcion": {
										"type": "string",
										"minLength": 1,
										"maxLength": 1,
										"pattern": "[A-Z]{1}"
									},
									"subclavePercepcion": {
										"type": "string",
										"minLength": 2,
										"maxLength": 2,
										"pattern": "[0-9]{2}"
									}
								}
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							}
						}
					},
					"meta": {
						"type": "object",
						"title": "PayrollMeta",
						"description": "Metadatos internos de la nómina",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					}
				},
				"description": "Versión simplificada de la nómina con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"Product": {
				"type": "object",
				"title": "Product",
				"required": [
					"main",
					"type",
					"uuid"
				],
				"additionalProperties": false,
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"product"
						]
					},
					"uuid": {
						"type": "string"
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"main": {
						"type": "object",
						"title": "ProductMain",
						"additionalProperties": false,
						"required": [
							"name",
							"currency"
						],
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del producto. Calculado automáticamente"
							},
							"name": {
								"type": "string"
							},
							"sku": {
								"type": "string"
							},
							"externalId": {
								"type": "string",
								"description": "ID externo del producto. Debe ser único entre todos los productos"
							},
							"sales": {
								"type": "object",
								"title": "ProductSales",
								"description": "Faceta de venta del producto. Si está presente, el producto se puede usar en documentos de venta (facturas, presupuestos, albaranes).",
								"additionalProperties": false,
								"required": [
									"account",
									"tax"
								],
								"properties": {
									"price": {
										"type": "number",
										"description": "Precio unitario por defecto cuando el producto se añade a un documento de venta. La interpretación de impuesto incluido/excluido depende del documento que lo incorpore."
									},
									"discountRate": {
										"type": "number",
										"description": "Descuento porcentual por defecto, expresado en base 1 (`0.10` = 10%)."
									},
									"description": {
										"type": "string",
										"description": "Descripción que aparece en las líneas de documentos de venta cuando se incorpora el producto."
									},
									"tax": {
										"type": "array",
										"title": "ProductSalesTaxes",
										"items": {
											"$ref": "#/components/schemas/TaxId"
										},
										"description": "Impuestos por defecto en líneas de venta. IDs del catálogo `GET /{companyId}/settings/taxes/sales`."
									},
									"account": {
										"$ref": "#/components/schemas/AccountCode",
										"description": "Cuenta contable de ingresos asociada al producto en operaciones de venta (típicamente del grupo 700)."
									}
								}
							},
							"purchases": {
								"type": "object",
								"title": "ProductPurchases",
								"description": "Faceta de compra del producto. Si está presente, el producto se puede usar en facturas de compra y tickets.",
								"additionalProperties": false,
								"required": [
									"account",
									"tax"
								],
								"properties": {
									"price": {
										"type": "number",
										"description": "Precio unitario por defecto cuando el producto se añade a un documento de compra."
									},
									"discountRate": {
										"type": "number",
										"description": "Descuento porcentual por defecto, expresado en base 1 (`0.10` = 10%)."
									},
									"description": {
										"type": "string",
										"description": "Descripción que aparece en las líneas de documentos de compra cuando se incorpora el producto."
									},
									"tax": {
										"type": "array",
										"title": "ProductPurchasesTaxes",
										"items": {
											"$ref": "#/components/schemas/TaxId"
										},
										"description": "Impuestos por defecto en líneas de compra. IDs del catálogo `GET /{companyId}/settings/taxes/purchases`."
									},
									"account": {
										"$ref": "#/components/schemas/AccountCode",
										"description": "Cuenta contable de gastos o inmovilizado asociada al producto en operaciones de compra (típicamente del grupo 600 para gastos corrientes, o del grupo 2 para inmovilizado amortizable)."
									},
									"depreciable": {
										"type": "boolean",
										"description": "Si es `true`, marca al producto como **bien amortizable** cuando se compra: indica al sistema contable que el gasto generado por este producto en una factura de compra debe tratarse como inmovilizado sujeto a amortización en vez de gasto corriente. Solo aplica a la faceta de compra."
									},
									"provider": {
										"type": "string",
										"description": "ID del contacto proveedor habitual al que se compra este producto. Se usa como proveedor por defecto de las líneas de pedido de cliente que incorporan el producto, para generar después órdenes de compra agrupadas por proveedor."
									}
								}
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los precios del producto (Formato ISO 4217)"
							},
							"stock": {
								"type": "object",
								"title": "ProductStock",
								"additionalProperties": false,
								"required": [
									"enabled"
								],
								"description": "Control de existencias del producto (opt-in). Las magnitudes de stock (físico, comprometido, previsto) no forman parte del producto: se consultan con el recurso de stock del producto.",
								"properties": {
									"enabled": {
										"type": "boolean",
										"description": "Si es `true`, el producto controla existencias: los documentos configurados mueven su stock y se registra cada movimiento en el kardex."
									},
									"minimum": {
										"type": "number",
										"minimum": 0,
										"description": "Stock mínimo deseado. Cuando el stock proyectado (disponible + previsto de órdenes pendientes) cae por debajo, el producto se marca como bajo mínimo y entra en la reposición sugerida del asistente de órdenes de compra."
									},
									"replenishLot": {
										"type": "number",
										"exclusiveMinimum": true,
										"description": "Lote de reposición opcional: cantidad propuesta al reponer (por defecto se propone la necesaria para volver al mínimo).",
										"minimum": 0
									}
								}
							}
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				}
			},
			"ProductStockInfo": {
				"type": "object",
				"title": "ProductStockInfo",
				"additionalProperties": false,
				"required": [
					"physical",
					"committed",
					"incoming",
					"available",
					"projected"
				],
				"properties": {
					"physical": {
						"type": "number",
						"description": "Stock físico (suma del libro de movimientos)"
					},
					"committed": {
						"type": "number",
						"description": "Comprometido en pedidos de cliente activos"
					},
					"incoming": {
						"type": "number",
						"description": "Previsto en órdenes de compra pendientes de recibir"
					},
					"available": {
						"type": "number",
						"description": "Disponible = físico − comprometido"
					},
					"projected": {
						"type": "number",
						"description": "Proyectado = disponible + previsto"
					}
				}
			},
			"ProductWrite": {
				"type": "object",
				"title": "ProductWrite",
				"required": [
					"main",
					"type"
				],
				"additionalProperties": false,
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"product"
						]
					},
					"uuid": {
						"type": "string"
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"main": {
						"type": "object",
						"title": "ProductMain",
						"additionalProperties": false,
						"required": [
							"name",
							"currency"
						],
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del producto. Calculado automáticamente"
							},
							"name": {
								"type": "string"
							},
							"sku": {
								"type": "string"
							},
							"externalId": {
								"type": "string",
								"description": "ID externo del producto. Debe ser único entre todos los productos"
							},
							"sales": {
								"type": "object",
								"title": "ProductSales",
								"description": "Faceta de venta del producto. Si está presente, el producto se puede usar en documentos de venta (facturas, presupuestos, albaranes).",
								"additionalProperties": false,
								"required": [
									"account",
									"tax"
								],
								"properties": {
									"price": {
										"type": "number",
										"description": "Precio unitario por defecto cuando el producto se añade a un documento de venta. La interpretación de impuesto incluido/excluido depende del documento que lo incorpore."
									},
									"discountRate": {
										"type": "number",
										"description": "Descuento porcentual por defecto, expresado en base 1 (`0.10` = 10%)."
									},
									"description": {
										"type": "string",
										"description": "Descripción que aparece en las líneas de documentos de venta cuando se incorpora el producto."
									},
									"tax": {
										"type": "array",
										"title": "ProductSalesTaxes",
										"items": {
											"$ref": "#/components/schemas/TaxId"
										},
										"description": "Impuestos por defecto en líneas de venta. IDs del catálogo `GET /{companyId}/settings/taxes/sales`."
									},
									"account": {
										"$ref": "#/components/schemas/AccountCode",
										"description": "Cuenta contable de ingresos asociada al producto en operaciones de venta (típicamente del grupo 700)."
									}
								}
							},
							"purchases": {
								"type": "object",
								"title": "ProductPurchases",
								"description": "Faceta de compra del producto. Si está presente, el producto se puede usar en facturas de compra y tickets.",
								"additionalProperties": false,
								"required": [
									"account",
									"tax"
								],
								"properties": {
									"price": {
										"type": "number",
										"description": "Precio unitario por defecto cuando el producto se añade a un documento de compra."
									},
									"discountRate": {
										"type": "number",
										"description": "Descuento porcentual por defecto, expresado en base 1 (`0.10` = 10%)."
									},
									"description": {
										"type": "string",
										"description": "Descripción que aparece en las líneas de documentos de compra cuando se incorpora el producto."
									},
									"tax": {
										"type": "array",
										"title": "ProductPurchasesTaxes",
										"items": {
											"$ref": "#/components/schemas/TaxId"
										},
										"description": "Impuestos por defecto en líneas de compra. IDs del catálogo `GET /{companyId}/settings/taxes/purchases`."
									},
									"account": {
										"$ref": "#/components/schemas/AccountCode",
										"description": "Cuenta contable de gastos o inmovilizado asociada al producto en operaciones de compra (típicamente del grupo 600 para gastos corrientes, o del grupo 2 para inmovilizado amortizable)."
									},
									"depreciable": {
										"type": "boolean",
										"description": "Si es `true`, marca al producto como **bien amortizable** cuando se compra: indica al sistema contable que el gasto generado por este producto en una factura de compra debe tratarse como inmovilizado sujeto a amortización en vez de gasto corriente. Solo aplica a la faceta de compra."
									},
									"provider": {
										"type": "string",
										"description": "ID del contacto proveedor habitual al que se compra este producto. Se usa como proveedor por defecto de las líneas de pedido de cliente que incorporan el producto, para generar después órdenes de compra agrupadas por proveedor."
									}
								}
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los precios del producto (Formato ISO 4217)"
							},
							"stock": {
								"type": "object",
								"title": "ProductStock",
								"additionalProperties": false,
								"required": [
									"enabled"
								],
								"description": "Control de existencias del producto (opt-in). Las magnitudes de stock (físico, comprometido, previsto) no forman parte del producto: se consultan con el recurso de stock del producto.",
								"properties": {
									"enabled": {
										"type": "boolean",
										"description": "Si es `true`, el producto controla existencias: los documentos configurados mueven su stock y se registra cada movimiento en el kardex."
									},
									"minimum": {
										"type": "number",
										"minimum": 0,
										"description": "Stock mínimo deseado. Cuando el stock proyectado (disponible + previsto de órdenes pendientes) cae por debajo, el producto se marca como bajo mínimo y entra en la reposición sugerida del asistente de órdenes de compra."
									},
									"replenishLot": {
										"type": "number",
										"exclusiveMinimum": true,
										"description": "Lote de reposición opcional: cantidad propuesta al reponer (por defecto se propone la necesaria para volver al mínimo).",
										"minimum": 0
									}
								}
							}
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				},
				"description": "Versión simplificada del producto con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"ProfileCompany": {
				"type": "object",
				"title": "ProfileCompany",
				"required": [
					"id",
					"name",
					"owner",
					"role",
					"taxCode"
				],
				"additionalProperties": false,
				"properties": {
					"id": {
						"type": "string"
					},
					"name": {
						"type": "string"
					},
					"taxCode": {
						"type": "string"
					},
					"brand": {
						"type": "string"
					},
					"owner": {
						"type": "string"
					},
					"role": {
						"type": "string"
					},
					"permissions": {
						"type": "object",
						"title": "ProfileCompanyPermissions",
						"description": "Solo con una aplicación conectada: permisos efectivos de la conexión en la empresa (lo concedido, limitado por el rol actual del usuario y por el plan). `read` es lectura y `full` lectura y escritura.",
						"additionalProperties": false,
						"properties": {
							"clients": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"providers": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"employees": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"products": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"invoices": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"recurringInvoices": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"estimates": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"deliveryNotes": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"clientOrders": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"bills": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"purchaseOrders": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"payrolls": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"tasks": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"banks": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"reconcile": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"paymentMethods": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"accounting": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"taxes": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"activity": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							},
							"companySettings": {
								"type": "string",
								"enum": [
									"read",
									"full"
								]
							}
						}
					},
					"accountingModule": {
						"type": "boolean",
						"description": "Solo con una aplicación conectada: si la empresa tiene el módulo de Contabilidad, contratado o incluido en su plan o en la prueba. Sin él no están disponibles los informes contables (pérdidas y ganancias, balance de situación y sumas y saldos)."
					},
					"manageUrl": {
						"type": "string",
						"description": "Solo con una aplicación conectada: página donde el usuario puede cambiar los permisos de la conexión en esta empresa"
					}
				}
			},
			"ProfileConnection": {
				"type": "object",
				"title": "ProfileConnection",
				"description": "Aplicación conectada con la que se ha hecho la petición (servidor MCP). Solo aparece con una conexión: entonces `companies` incluye solo las empresas que el usuario eligió para ella.",
				"required": [
					"id",
					"clientName",
					"manageUrl"
				],
				"additionalProperties": false,
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador de la conexión"
					},
					"clientName": {
						"type": "string",
						"description": "Nombre de la aplicación conectada"
					},
					"manageUrl": {
						"type": "string",
						"description": "Página de FacturaDirecta donde el usuario puede cambiar las empresas y los permisos de la conexión"
					}
				}
			},
			"ProfileUser": {
				"type": "object",
				"title": "ProfileUser",
				"required": [
					"username",
					"email",
					"firstName",
					"lastName",
					"companies"
				],
				"additionalProperties": false,
				"properties": {
					"username": {
						"type": "string"
					},
					"email": {
						"type": "string"
					},
					"firstName": {
						"type": "string"
					},
					"lastName": {
						"type": "string"
					},
					"companies": {
						"type": "array",
						"title": "Companies",
						"items": {
							"$ref": "#/components/schemas/ProfileCompany"
						}
					},
					"connection": {
						"$ref": "#/components/schemas/ProfileConnection"
					}
				}
			},
			"PublicApiKeyInfo": {
				"type": "object",
				"title": "PublicApiKeyInfo",
				"additionalProperties": false,
				"required": [
					"id",
					"name",
					"prefix",
					"scopes",
					"creationTime",
					"managedViaApi"
				],
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador único de la API key"
					},
					"name": {
						"type": "string",
						"description": "Nombre descriptivo de la API key"
					},
					"prefix": {
						"type": "string",
						"description": "Prefijo de 6 caracteres de la API key para identificación"
					},
					"scopes": {
						"type": "array",
						"items": {
							"type": "string"
						},
						"description": "Lista de scopes autorizados"
					},
					"creationTime": {
						"type": "string",
						"description": "Fecha de creación (ISO 8601)"
					},
					"createdBy": {
						"type": "string",
						"description": "Usuario que creó la API key"
					},
					"managedViaApi": {
						"type": "boolean",
						"description": "Indica si la API key fue creada vía API y puede ser eliminada vía API"
					}
				}
			},
			"PublicApiPresignedUpload": {
				"type": "object",
				"title": "PublicApiPresignedUpload",
				"additionalProperties": false,
				"required": [
					"id",
					"name",
					"contentType",
					"signedRequest",
					"expiresAt"
				],
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador del upload (prefijo `upl_`)"
					},
					"name": {
						"type": "string",
						"description": "Nombre del archivo solicitado"
					},
					"contentType": {
						"type": "string",
						"description": "MIME type indicado (puede haber sido normalizado)"
					},
					"signedRequest": {
						"type": "string",
						"description": "URL pre-firmada de S3 para hacer PUT con el binario. Tras el PUT, llama a POST /uploads/{uploadId}/commit para sellar."
					},
					"expiresAt": {
						"type": "string",
						"format": "date-time",
						"description": "Fecha límite para hacer el PUT y el commit."
					}
				}
			},
			"PublicApiUpload": {
				"type": "object",
				"title": "PublicApiUpload",
				"additionalProperties": false,
				"required": [
					"id",
					"name",
					"size",
					"contentType",
					"expiresAt"
				],
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador del upload (prefijo `upl_`). Úsalo para vincular el archivo a un documento."
					},
					"name": {
						"type": "string",
						"description": "Nombre original del archivo"
					},
					"size": {
						"type": "integer",
						"description": "Tamaño del archivo en bytes"
					},
					"contentType": {
						"type": "string",
						"description": "MIME type detectado (puede haber sido normalizado, p.ej. text/xml → application/xml)"
					},
					"contentSubtype": {
						"type": "string",
						"nullable": true,
						"enum": [
							"facturae",
							null
						],
						"description": "Subtipo detectado automáticamente. `facturae` si se ha detectado un XML Facturae válido."
					},
					"expiresAt": {
						"type": "string",
						"format": "date-time",
						"description": "Fecha límite para vincular este upload a un documento. Pasada esta fecha, el upload caduca y se purga."
					}
				}
			},
			"PublicStockMovement": {
				"type": "object",
				"title": "PublicStockMovement",
				"additionalProperties": false,
				"required": [
					"id",
					"date",
					"quantity",
					"type",
					"warehouse",
					"creationDate",
					"balanceAfter"
				],
				"properties": {
					"id": {
						"type": "string"
					},
					"date": {
						"type": "string",
						"description": "Fecha efectiva del movimiento"
					},
					"quantity": {
						"type": "number",
						"description": "Cantidad firmada (+entrada / −salida)"
					},
					"type": {
						"type": "string",
						"enum": [
							"initial",
							"reception",
							"delivery",
							"adjustment",
							"count",
							"transfer"
						]
					},
					"warehouse": {
						"type": "string",
						"description": "Identificador estable del almacén"
					},
					"transferGroup": {
						"type": "string",
						"nullable": true,
						"description": "Identificador compartido por las dos patas de una transferencia"
					},
					"reason": {
						"type": "string",
						"nullable": true,
						"enum": [
							"merma",
							"rotura",
							"robo",
							"caducidad",
							"consumo_propio",
							"muestra_regalo",
							"correccion"
						]
					},
					"sourceDocument": {
						"type": "string",
						"nullable": true,
						"description": "ID del documento que generó el movimiento"
					},
					"note": {
						"type": "string",
						"nullable": true
					},
					"creationDate": {
						"type": "string"
					},
					"balanceAfter": {
						"type": "number",
						"description": "Saldo del producto en el almacén tras este movimiento"
					}
				}
			},
			"PurchaseOrder": {
				"type": "object",
				"title": "PurchaseOrder",
				"required": [
					"uuid",
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"purchaseOrder"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"main": {
						"type": "object",
						"title": "PurchaseOrderMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"state": {
								"type": "string",
								"enum": [
									"pending",
									"received",
									"canceled"
								],
								"description": "Estado de la orden de compra. Se calcula automáticamente a partir del estado de sus líneas (`lines[].state`) con esta prioridad: si alguna línea está `pending` la orden está `pending` (pendiente de recibir); si no, si alguna está `received` la orden está `received`; si todas están `canceled` la orden está `canceled`. Para cambiar el estado de la orden se cambian los estados de sus líneas."
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del proveedor (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes de la orden (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumber"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha de recepción prevista de la mercancía",
								"nullable": true
							},
							"emails": {
								"type": "string"
							},
							"emailsCc": {
								"type": "string"
							},
							"emailsBcc": {
								"type": "string"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "PurchaseOrderLines",
								"items": {
									"$ref": "#/components/schemas/PurchaseOrderMainLine"
								}
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles de la orden",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/PurchasesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"manualTotals": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas de la orden, no serán visibles en el documento impreso"
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							}
						},
						"required": [
							"account",
							"currency",
							"state",
							"date",
							"docNumber",
							"dueDate",
							"exchangeRate",
							"fiscalPosition",
							"lines",
							"lineTotalDecimals",
							"linesTotal",
							"taxes",
							"taxIncludedPrices",
							"theme",
							"total"
						]
					},
					"meta": {
						"type": "object",
						"title": "PurchaseOrderMeta",
						"description": "Metadatos internos de la orden",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				}
			},
			"PurchaseOrderMainLine": {
				"type": "object",
				"title": "PurchaseOrderMainLine",
				"additionalProperties": false,
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador estable de la línea dentro de la orden. Lo genera FacturaDirecta si no se indica. Al actualizar la orden, las líneas que incluyan un `id` existente conservan su identidad (y por tanto sus vínculos con otros documentos); las líneas sin `id` se tratan como líneas nuevas."
					},
					"state": {
						"type": "string",
						"enum": [
							"pending",
							"received",
							"canceled"
						],
						"description": "Estado de la línea de la orden: `pending` (pendiente de recibir), `received` (recibida) o `canceled` (cancelada). El estado de la orden se calcula a partir de los estados de sus líneas."
					},
					"client": {
						"type": "string",
						"description": "ID del contacto cliente para el que se compra esta línea (trazabilidad de compras bajo pedido). Lo gestiona FacturaDirecta cuando la línea proviene de un pedido de cliente.",
						"nullable": true
					},
					"clientOrder": {
						"type": "string",
						"description": "ID del pedido de cliente vinculado a esta línea. Lo gestiona FacturaDirecta al generar la orden desde pedidos.",
						"nullable": true
					},
					"clientOrderLine": {
						"type": "string",
						"description": "ID de la línea del pedido de cliente vinculada a esta línea. Lo gestiona FacturaDirecta al generar la orden desde pedidos.",
						"nullable": true
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "PurchaseOrderLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de compras de la empresa con `GET /{companyId}/settings/taxes/purchases`.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.purchases.tax`) como base y aplica automáticamente la posición fiscal del contacto.\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.purchases`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					}
				},
				"required": [
					"id",
					"state",
					"account",
					"discount",
					"discountRate",
					"lineTotal",
					"quantity",
					"text",
					"unitPrice"
				]
			},
			"PurchaseOrderMainLineWrite": {
				"type": "object",
				"title": "PurchaseOrderMainLineWrite",
				"additionalProperties": false,
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador estable de la línea dentro de la orden. Lo genera FacturaDirecta si no se indica. Al actualizar la orden, las líneas que incluyan un `id` existente conservan su identidad (y por tanto sus vínculos con otros documentos); las líneas sin `id` se tratan como líneas nuevas."
					},
					"state": {
						"type": "string",
						"enum": [
							"pending",
							"received",
							"canceled"
						],
						"description": "Estado de la línea de la orden: `pending` (pendiente de recibir), `received` (recibida) o `canceled` (cancelada). El estado de la orden se calcula a partir de los estados de sus líneas."
					},
					"client": {
						"type": "string",
						"description": "ID del contacto cliente para el que se compra esta línea (trazabilidad de compras bajo pedido). Lo gestiona FacturaDirecta cuando la línea proviene de un pedido de cliente.",
						"nullable": true
					},
					"clientOrder": {
						"type": "string",
						"description": "ID del pedido de cliente vinculado a esta línea. Lo gestiona FacturaDirecta al generar la orden desde pedidos.",
						"nullable": true
					},
					"clientOrderLine": {
						"type": "string",
						"description": "ID de la línea del pedido de cliente vinculada a esta línea. Lo gestiona FacturaDirecta al generar la orden desde pedidos.",
						"nullable": true
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"document": {
						"type": "string",
						"description": "Si esta línea se ha generado a partir de un producto puedes indicar aquí su ID"
					},
					"discount": {
						"type": "number"
					},
					"discountRate": {
						"type": "number"
					},
					"lineTotal": {
						"type": "number"
					},
					"quantity": {
						"type": "number"
					},
					"tax": {
						"type": "array",
						"title": "PurchaseOrderLineTaxes",
						"items": {
							"$ref": "#/components/schemas/TaxId"
						},
						"description": "Array de identificadores de impuesto (`TaxId`) que aplican a esta línea. Los identificadores se obtienen del catálogo de impuestos de compras de la empresa con `GET /{companyId}/settings/taxes/purchases`.\n\n**En la API pública este campo es opcional al crear o actualizar el documento.** Comportamiento cuando no se envía o llega vacío:\n- Si se omite y la línea referencia un producto en `document`, FacturaDirecta usa los impuestos del producto (`product.purchases.tax`) como base y aplica automáticamente la posición fiscal del contacto.\n- Si se omite y no hay producto, se usan los impuestos por defecto de la empresa (`settings.taxes.purchases`) y se aplica la posición fiscal del contacto.\n- Si se envía `tax: []` (array vacío) se interpreta como \"línea sin impuestos\" y no se completa con defaults ni se transforma.\n- Si se envía un array no vacío se respetan los identificadores exactos enviados, sin transformación adicional."
					},
					"text": {
						"type": "string"
					},
					"unitPrice": {
						"type": "number"
					}
				},
				"required": [
					"quantity",
					"text",
					"unitPrice"
				],
				"description": "Versión de la línea de orden de compra para creación del documento. Si no se indica `id` FacturaDirecta genera uno nuevo, y si no se indica `state` la línea se crea como `pending`"
			},
			"PurchaseOrderResponse": {
				"type": "object",
				"title": "PurchaseOrderResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/PurchaseOrder"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "PurchaseOrderRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "PurchaseOrderRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/TaxDefinition"
											}
										]
									}
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"PurchaseOrderWrite": {
				"type": "object",
				"title": "PurchaseOrderWrite",
				"required": [
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"type": "string",
						"enum": [
							"purchaseOrder"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/AttachmentWrite"
						},
						"maxItems": 10
					},
					"main": {
						"type": "object",
						"title": "PurchaseOrderMain",
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string",
								"description": "Título del documento para identificarlo en los listados, se calcula automáticamente"
							},
							"state": {
								"type": "string",
								"enum": [
									"pending",
									"received",
									"canceled"
								],
								"description": "Estado de la orden de compra. Se calcula automáticamente a partir del estado de sus líneas (`lines[].state`) con esta prioridad: si alguna línea está `pending` la orden está `pending` (pendiente de recibir); si no, si alguna está `received` la orden está `received`; si todas están `canceled` la orden está `canceled`. Para cambiar el estado de la orden se cambian los estados de sus líneas."
							},
							"address": {
								"type": "string"
							},
							"country": {
								"type": "string",
								"description": "País de la dirección fiscal del proveedor (Formato ISO 3166-1 Alpha-2)",
								"nullable": true
							},
							"zipcode": {
								"type": "string",
								"nullable": true
							},
							"contact": {
								"type": "string",
								"nullable": true
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"fiscalPosition": {
								"$ref": "#/components/schemas/FiscalPosition"
							},
							"currency": {
								"type": "string",
								"description": "Moneda de los importes de la orden (Formato ISO 4217)"
							},
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"docNumber": {
								"$ref": "#/components/schemas/DocNumberWrite"
							},
							"dueDate": {
								"type": "string",
								"format": "date",
								"description": "Fecha de recepción prevista de la mercancía",
								"nullable": true
							},
							"emails": {
								"type": "string"
							},
							"emailsCc": {
								"type": "string"
							},
							"emailsBcc": {
								"type": "string"
							},
							"exchangeRate": {
								"type": "number",
								"minimum": 0,
								"exclusiveMinimum": true,
								"description": "Tipo de cambio de la moneda del documento respecto a la moneda de la empresa. En la moneda de la empresa es siempre 1. Opcional al crear y al actualizar: si no se indica, se toma el de la fecha del documento (`date`) y, al actualizar, se conserva el anterior mientras no cambien la moneda ni la fecha"
							},
							"lines": {
								"type": "array",
								"title": "PurchaseOrderLines",
								"items": {
									"$ref": "#/components/schemas/PurchaseOrderMainLineWrite"
								}
							},
							"lineTotalDecimals": {
								"type": "number",
								"minimum": 2,
								"maximum": 6,
								"multipleOf": 1
							},
							"notes": {
								"type": "string",
								"description": "Notas visibles de la orden",
								"nullable": true
							},
							"showProductColumn": {
								"type": "boolean"
							},
							"showQuantityColumn": {
								"type": "boolean"
							},
							"warehouse": {
								"type": "string",
								"description": "Almacén del documento a efectos de stock (feature `warehouses`). Si no se indica, los movimientos de stock van al almacén por defecto de la empresa."
							},
							"showDiscountColumn": {
								"type": "boolean"
							},
							"linesTotal": {
								"type": "number",
								"description": "Importe total de las líneas. Calculado automáticamente"
							},
							"taxes": {
								"$ref": "#/components/schemas/PurchasesDocumentTaxes",
								"readOnly": true
							},
							"taxIncludedPrices": {
								"type": "boolean"
							},
							"totalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos. Calculado automáticamente"
							},
							"companyCurrencyTotalBeforeTaxes": {
								"type": "number",
								"description": "Importe total antes de impuestos en la moneda de la contabilidad. Calculado automáticamente"
							},
							"paymentMethod": {
								"type": "string",
								"nullable": true
							},
							"theme": {
								"type": "string"
							},
							"language": {
								"type": "string",
								"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
								"description": "Idioma en que se imprime y se envía el documento; sin valor, el idioma base de su plantilla"
							},
							"total": {
								"type": "number"
							},
							"companyCurrencyTotal": {
								"type": "number",
								"description": "Importe total en la moneda de la contabilidad. Calculado automáticamente"
							},
							"internalNotes": {
								"type": "string",
								"description": "Notas internas de la orden, no serán visibles en el documento impreso"
							},
							"counterpart": {
								"$ref": "#/components/schemas/DocumentCounterpart"
							},
							"customFields": {
								"type": "object",
								"additionalProperties": {
									"type": "string"
								},
								"description": "Valores de campos personalizados"
							}
						},
						"required": [
							"docNumber",
							"lines"
						]
					},
					"meta": {
						"type": "object",
						"title": "PurchaseOrderMeta",
						"description": "Metadatos internos de la orden",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					}
				},
				"description": "Versión simplificada de la orden de compra con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"PurchasesTax": {
				"type": "object",
				"title": "PurchasesTax",
				"description": "Impuesto de compra",
				"required": [
					"id",
					"taxGroup",
					"value",
					"account",
					"title",
					"shortTitle",
					"current",
					"country",
					"selectorFlags"
				],
				"additionalProperties": false,
				"properties": {
					"id": {
						"type": "string"
					},
					"taxGroup": {
						"type": "string",
						"description": "Grupo de impuestos.\n\n  No se debe asumir que siempre van a existir estos valores, si hay cambios normativos pueden definirse nuevos valores en cualquier momento.\n\n  Los grupos disponibles en cada empresas pueden ser distintos según su dirección fiscal.\n  \n  * IVA: IVA\n  * IVA_RE: IVA de recargo de equivalencia\n  * IGIC: Impuesto General Indirecto Canario (Canarias)\n  * IPSI: Impuesto sobre la Producción, los Servicios y la Importación (Ceuta y Melilla)\n  * IRPF: Retención de IRPF\n  ",
						"enum": [
							"IVA",
							"IVA_RE",
							"IGIC",
							"IPSI",
							"IRPF"
						]
					},
					"value": {
						"type": "number",
						"description": "Porcentaje del impuesto en base 1.\n\nValor: 0.21 para IVA 21%"
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"title": {
						"type": "string",
						"description": "Nombre completo del impuesto"
					},
					"shortTitle": {
						"type": "string",
						"description": "Nombre corto del impuesto"
					},
					"current": {
						"type": "boolean",
						"description": "Indica si es un impuesto vigente actualmente"
					},
					"country": {
						"type": "string",
						"description": "País de recaudación del impuesto (Formato ISO 3166-1 Alpha-2)"
					},
					"category": {
						"type": "string",
						"description": "Categoría funcional del impuesto. Permite agrupar y filtrar los impuestos por su función en el sistema fiscal.\n\nNo se debe asumir que siempre van a existir estos valores, si hay cambios normativos pueden definirse nuevos valores en cualquier momento.\n\n* standard_vat: IVA/IGIC/IPSI estándar (tipos normal, reducido, superreducido y temporales)\n* exempt_vat: Operación exenta de IVA/IGIC\n* intra_community: Operación intracomunitaria. En compras se genera automáticamente un par autorepercutido (efecto neto cero)\n* reverse_charge: Inversión del sujeto pasivo. El comprador liquida el impuesto en lugar del vendedor\n* equivalence_surcharge: Recargo de equivalencia (régimen especial de comerciantes minoristas)\n* withholding: Retención de IRPF a cuenta del impuesto sobre la renta del perceptor\n* rental_withholding: Retención de IRPF por alquiler de inmueble urbano\n* pass_through: Suplidos: gastos pagados en nombre de un tercero, sin IVA\n* import_customs: Importación de bienes tramitada por aduana (DUA). El IVA se paga en aduana y es deducible\n* import_services: Importación de servicios extracomunitarios (genera par autorepercutido)\n* import_pending_customs: Importación pendiente de despacho aduanero (IVA al 0% temporal)\n* agriculture: Compensación a explotaciones en régimen especial de agricultura\n",
						"enum": [
							"standard_vat",
							"exempt_vat",
							"intra_community",
							"reverse_charge",
							"equivalence_surcharge",
							"withholding",
							"rental_withholding",
							"pass_through",
							"import_customs",
							"import_services",
							"import_pending_customs",
							"agriculture"
						]
					},
					"description": {
						"type": "string",
						"description": "Explicación breve, en español, del propósito y funcionamiento de este impuesto. Orientada a ayudar al integrador a elegir el impuesto correcto para cada operación."
					},
					"selectorFlags": {
						"type": "array",
						"description": "Indica dónde puede el usuario aplicar este impuesto:\n\n* product: Puede asignarse a un producto del catálogo como impuesto por defecto.\n* line: Puede aplicarse en líneas de documentos (facturas, presupuestos, gastos, etc.).\n\nUn array vacío indica un impuesto que no se selecciona manualmente. Es el caso de los impuestos autorepercutidos: se aplican automáticamente cuando se usa su impuesto pareja (ver `pairedWith` y `autoApplied`).",
						"items": {
							"type": "string",
							"enum": [
								"product",
								"line"
							]
						}
					},
					"autoApplied": {
						"type": "boolean",
						"description": "Si es `true`, este impuesto se aplica automáticamente cuando se usa el impuesto referenciado en `pairedWith`. El usuario no lo selecciona directamente.\n\nEs el mecanismo de los impuestos autorepercutidos: en compras intracomunitarias, inversión del sujeto pasivo o importación de servicios extracomunitarios, el sistema genera un par de impuestos (uno deducible y otro devengado) cuyo efecto neto es cero pero ambos deben quedar reflejados en la declaración."
					},
					"pairedWith": {
						"type": "string",
						"description": "Identificador del impuesto pareja al que está vinculado este impuesto.\n\n* En el impuesto base (no autorepercutido) apunta al impuesto autorepercutido que se generará automáticamente cuando se aplique.\n* En el impuesto autorepercutido (`autoApplied: true`) apunta al impuesto base que dispara su aplicación automática."
					},
					"lineAmountIsTax": {
						"type": "boolean",
						"description": "Si es `true`, el comportamiento de la línea de gasto que use este impuesto es **especial**: el importe de la línea es directamente la cuota de IVA, no la base imponible.\n\nAplica al IVA de importación tramitado por aduana (DUA), donde la aduana repercute al importador una cuota global de IVA que se anota tal cual, sin recalcular `base × tipo`. Es responsabilidad del integrador detectar este flag y tratar el importe de la línea como cuota directa."
					}
				}
			},
			"ReconcileStatementResponse": {
				"type": "object",
				"title": "ReconcileStatementResponse",
				"description": "Resultado de la operación de conciliación",
				"additionalProperties": false,
				"required": [
					"content"
				],
				"properties": {
					"content": {
						"type": "object",
						"required": [
							"uuid",
							"state",
							"matchedDocument"
						],
						"properties": {
							"uuid": {
								"type": "string",
								"description": "Identificador del extracto bancario"
							},
							"state": {
								"type": "string",
								"enum": [
									"reconciled",
									"pending"
								],
								"description": "Estado de conciliación tras la operación"
							},
							"matchedDocument": {
								"type": "string",
								"nullable": true,
								"description": "Identificador del documento conciliado"
							}
						}
					}
				}
			},
			"ReconcileWithNewTransactionResponse": {
				"type": "object",
				"title": "ReconcileWithNewTransactionResponse",
				"description": "Resultado de la conciliación con creación de asiento contable",
				"additionalProperties": false,
				"required": [
					"content",
					"transaction",
					"creationDate",
					"modificationDate"
				],
				"properties": {
					"content": {
						"$ref": "#/components/schemas/StatementContent"
					},
					"transaction": {
						"$ref": "#/components/schemas/Transaction"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					}
				}
			},
			"RecurringInvoice": {
				"type": "object",
				"title": "RecurringInvoice",
				"required": [
					"type",
					"main",
					"uuid"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"enum": [
							"automation"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"meta": {
						"$ref": "#/components/schemas/AutomationMeta"
					},
					"main": {
						"type": "object",
						"required": [
							"title",
							"enabled",
							"trigger",
							"action"
						],
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string"
							},
							"enabled": {
								"type": "boolean"
							},
							"trigger": {
								"$ref": "#/components/schemas/RecurringTrigger"
							},
							"action": {
								"$ref": "#/components/schemas/RecurringInvoiceAction"
							}
						}
					}
				}
			},
			"RecurringInvoiceAction": {
				"type": "object",
				"required": [
					"type",
					"template"
				],
				"additionalProperties": false,
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"createDocument"
						]
					},
					"template": {
						"$ref": "#/components/schemas/Invoice"
					},
					"send": {
						"description": "Enviar la factura generada por correo electrónico en el momento de generarse",
						"type": "boolean"
					},
					"emailFrom": {
						"description": "Remitente utilizado si se envía la factura generada por correo electrónico en el momento de generarla",
						"type": "string"
					},
					"dueDateDelta": {
						"description": "Días de plazo para el vencimiento de la factura creada",
						"type": "integer"
					},
					"disabledDayContact": {
						"description": "Ignorar la configuración de días de pago del contacto para determinar el vencimiento de la factura creada",
						"type": "boolean"
					},
					"sendFacturae": {
						"description": "Incluir la factura generada en formato facturae si se envía por correo electrónico en el momento de generarla",
						"type": "boolean"
					}
				},
				"title": "RecurringInvoiceAction"
			},
			"RecurringInvoiceActionWrite": {
				"type": "object",
				"required": [
					"type",
					"template"
				],
				"additionalProperties": false,
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"createDocument"
						]
					},
					"template": {
						"$ref": "#/components/schemas/InvoiceWrite"
					},
					"send": {
						"description": "Enviar la factura generada por correo electrónico en el momento de generarse",
						"type": "boolean"
					},
					"emailFrom": {
						"description": "Remitente utilizado si se envía la factura generada por correo electrónico en el momento de generarla",
						"type": "string"
					},
					"dueDateDelta": {
						"description": "Días de plazo para el vencimiento de la factura creada",
						"type": "integer"
					},
					"disabledDayContact": {
						"description": "Ignorar la configuración de días de pago del contacto para determinar el vencimiento de la factura creada",
						"type": "boolean"
					},
					"sendFacturae": {
						"description": "Incluir la factura generada en formato facturae si se envía por correo electrónico en el momento de generarla",
						"type": "boolean"
					}
				},
				"title": "RecurringInvoiceActionWrite"
			},
			"RecurringInvoiceResponse": {
				"type": "object",
				"title": "RecurringInvoiceResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/RecurringInvoice"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "RecurringInvoiceRelated",
						"additionalProperties": false,
						"properties": {
							"objects": {
								"type": "object",
								"title": "RecurringInvoiceRelatedObjects",
								"description": "Mapa de objetos relacionados solicitados, cada clave de este objeto es el id de un objeto relacionado y el valor es el contenido del mismo",
								"properties": {
									"object_id": {
										"anyOf": [
											{
												"$ref": "#/components/schemas/TaxDefinition"
											}
										]
									}
								}
							},
							"nextScheduledTime": {
								"title": "NextScheduledTime",
								"description": "Fecha y hora programada de próxima ejecución.",
								"type": "string",
								"format": "date-time"
							},
							"upcomingSceheduledTimes": {
								"title": "UpcominigScheduledTimes",
								"description": "5 próximas fechas y horas de ejecución programadas.",
								"type": "array",
								"minItems": 0,
								"maxItems": 5,
								"items": {
									"type": "string",
									"format": "date-time"
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"RecurringInvoiceWrite": {
				"type": "object",
				"title": "RecurringInvoiceWrite",
				"required": [
					"type",
					"main"
				],
				"additionalProperties": false,
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"enum": [
							"automation"
						]
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"meta": {
						"$ref": "#/components/schemas/AutomationMeta"
					},
					"main": {
						"type": "object",
						"required": [
							"title",
							"enabled",
							"trigger",
							"action"
						],
						"additionalProperties": false,
						"properties": {
							"title": {
								"type": "string"
							},
							"enabled": {
								"type": "boolean"
							},
							"trigger": {
								"$ref": "#/components/schemas/RecurringTrigger"
							},
							"action": {
								"$ref": "#/components/schemas/RecurringInvoiceActionWrite"
							}
						}
					}
				},
				"description": "Versión simplificada de la factura recurrente con los elementos que calcula automáticamente FacturaDirecta marcados como no obligatorios"
			},
			"RecurringTrigger": {
				"type": "object",
				"title": "RecurringTrigger",
				"required": [
					"type",
					"rrule"
				],
				"additionalProperties": false,
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"recurring"
						]
					},
					"daysAdvance": {
						"description": "Para uso futuro, indicar siempre cero",
						"type": "integer",
						"minimum": 0,
						"maximum": 0
					},
					"rrule": {
						"description": "Definición de los parámetros de ejecución recurrente",
						"type": "object",
						"required": [
							"freq",
							"interval",
							"dtstart"
						],
						"additionalProperties": false,
						"properties": {
							"dtstart": {
								"description": "Fecha de inicio, se empezarán a evaluar las ejecuciones solo a partir de la fecha indicada en formato ISO, ejemplo: \"2040-01-01T06:00:00.000Z\"",
								"type": "string",
								"format": "date-time"
							},
							"until": {
								"description": "Fecha de fin. Si se indica no se ejecutará ninguna después de esta fecha indicada en formato ISO, ejemplo: \"2042-01-01T06:00:00.000Z\"\n\nSolo puede indicarse uno de los valores `until` o `count`",
								"type": "string",
								"format": "date-time"
							},
							"count": {
								"description": "Número de ejecuciones totales. Se contabilizan a partir del valor indicado en `dtstart`.\n\nSolo puede indicarse uno de los valores `until` o `count`",
								"type": "integer",
								"minimum": 1
							},
							"freq": {
								"description": "Frecuencia de ejecución, se usa junto a `interval` Valores posibles:\n\n* daily: Diario\n* weekly: Semanal\n* monthly: Mensual\n* yearly: Anual",
								"enum": [
									"yearly",
									"monthly",
									"weekly",
									"daily"
								]
							},
							"interval": {
								"description": "Número de unidades de tiempo indicadas por `interval` cada las cuales se ejecuta\n\n* Para `freq=daily` cada cuántos días\n* Para `freq=weekly` cada cuántas semanas\n* Para `freq=monthly` cada cuántos meses\n* Para `freq=yearly` cada cuántos años\n",
								"type": "integer",
								"minimum": 1
							},
							"bymonth": {
								"description": "Para `freq=yearly` permite indicar el mes de ejecución (1=Enero, 12=Diciembre)",
								"type": "integer",
								"minimum": 1,
								"maximum": 12
							},
							"bymonthday": {
								"description": "Para `freq=monthly` y `freq=yearly` permite indicar el día del mes de ejecución (1=Enero, 12=Diciembre)\n\nAcepta valores entre -1 y 31 con las siguientes restricciones:\n* Para `freq=monthly` el valor máximo permitido es 28.\n* El valor 0 no está permitido",
								"anyOf": [
									{
										"type": "integer",
										"minimum": 1,
										"maximum": 31
									},
									{
										"type": "integer",
										"minimum": -1,
										"maximum": -1
									}
								]
							},
							"byweekday": {
								"description": "Para `freq=weekly` y `freq=monthly` permite indicar el día de la semana de ejecución (0=Lunes, 6=Domingo)",
								"type": "integer",
								"minimum": 0,
								"maximum": 6
							},
							"bysetpos": {
								"description": "Solo aplica a `freq=monthly`. Permite elegir el último (-1) o del primer (1) al cuarto (4) día de la semana, en este caso el día de la semana se indica con `byweekday` y es obligatorio indicarlo si se selecciona `bysetpos`",
								"anyOf": [
									{
										"type": "integer",
										"minimum": 1,
										"maximum": 4
									},
									{
										"type": "integer",
										"minimum": -1,
										"maximum": -1
									}
								]
							}
						}
					}
				}
			},
			"RelatedJournalEntry": {
				"type": "object",
				"title": "RelatedJournalEntry",
				"description": "Apunte contable que afecta al saldo del documento padre. Forma reducida de la fila devuelta por `GET /journal` (sin `idAccounting`, `tags`, `journalPriority` ni los campos `document*` redundantes con el documento padre).",
				"required": [
					"id",
					"idType",
					"idLineIndex",
					"date",
					"debit",
					"credit",
					"account",
					"accountTitle"
				],
				"properties": {
					"id": {
						"type": "string",
						"description": "ID del documento que origina el apunte. Polimórfico: `tra_<uuid-v4>` para asientos contables directos, `pay_<uuid-v4>` para remesas SEPA. El `idType` indica el tipo concreto.",
						"pattern": "^(tra_|pay_)[0-9a-f-]+$"
					},
					"idType": {
						"type": "string",
						"description": "Tipo del documento referenciado por `id`. Hoy `transaction` (asiento directo) o `payment` (remesa SEPA), pero el contrato es polimórfico para acomodar tipos futuros.",
						"enum": [
							"transaction",
							"payment"
						]
					},
					"idTitle": {
						"type": "string",
						"nullable": true,
						"description": "Texto descriptivo del apunte (mismo valor que devuelve `GET /journal` en el campo `idTitle`). Puede ser `null` si el apunte no tiene texto asignado."
					},
					"idSummary": {
						"type": "string",
						"nullable": true,
						"description": "Resumen del documento que origina el apunte. Puede ser `null` para apuntes sin resumen disponible."
					},
					"idLineIndex": {
						"type": "number",
						"description": "Índice de la línea del asiento dentro del documento (0-based)."
					},
					"date": {
						"type": "string",
						"format": "date",
						"description": "Fecha contable del apunte."
					},
					"debit": {
						"type": "number",
						"description": "Importe del apunte en el debe (en la moneda de la contabilidad de la empresa)."
					},
					"credit": {
						"type": "number",
						"description": "Importe del apunte en el haber (en la moneda de la contabilidad de la empresa)."
					},
					"currency": {
						"type": "string",
						"description": "Moneda original del apunte (formato ISO 4217). Sólo aparece cuando la empresa tiene multicurrency activada y el apunte está en una moneda distinta a la de la contabilidad."
					},
					"currencyDebit": {
						"type": "number",
						"description": "Importe en el debe en la moneda original. Sólo aparece cuando la empresa tiene multicurrency activada."
					},
					"currencyCredit": {
						"type": "number",
						"description": "Importe en el haber en la moneda original. Sólo aparece cuando la empresa tiene multicurrency activada."
					},
					"account": {
						"type": "string",
						"description": "Código de cuenta contable (PGC) del apunte."
					},
					"accountTitle": {
						"type": "string",
						"description": "Nombre de la cuenta contable."
					}
				}
			},
			"ReportColumn": {
				"type": "object",
				"title": "ReportColumn",
				"description": "Columna de un informe: de fechas (`movement`, `balanceAt`) o calculada a partir de otras (`difference`, `varianceRatio`, `shareOfRow`)",
				"additionalProperties": false,
				"required": [
					"id",
					"kind"
				],
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador de la columna, la clave de `values` en cada fila: `current` y `reference` con `compare`, `p0`, `p1`... y `total` con `breakdown`"
					},
					"kind": {
						"type": "string",
						"enum": [
							"movement",
							"balanceAt",
							"difference",
							"varianceRatio",
							"shareOfRow"
						],
						"description": "Tipo de columna:\n\n* movement: Importes del periodo entre `start` y `end`\n* balanceAt: Saldo acumulado a `date` (balance de situación)\n* difference: `current` menos `reference`\n* varianceRatio: `(current - reference) / |reference|`, como fracción\n* shareOfRow: Valor de la fila sobre el de la fila `row` en la columna `column`, como fracción"
					},
					"start": {
						"type": "string",
						"format": "date",
						"description": "Primer día del periodo (`movement`)"
					},
					"end": {
						"type": "string",
						"format": "date",
						"description": "Último día del periodo, incluido (`movement`)"
					},
					"date": {
						"type": "string",
						"format": "date",
						"description": "Fecha del saldo (`balanceAt`)"
					},
					"current": {
						"type": "string",
						"description": "Columna que se compara (`difference`, `varianceRatio`)"
					},
					"reference": {
						"type": "string",
						"description": "Columna de referencia (`difference`, `varianceRatio`)"
					},
					"column": {
						"type": "string",
						"description": "Columna de la que se calcula el peso (`shareOfRow`)"
					},
					"row": {
						"type": "string",
						"description": "Fila que hace de base (`shareOfRow`)"
					}
				}
			},
			"ResultsDetailReport": {
				"type": "object",
				"title": "ResultsDetailReport",
				"additionalProperties": false,
				"required": [
					"meta",
					"items",
					"pagination"
				],
				"properties": {
					"meta": {
						"type": "object",
						"title": "ResultsDetailReportMeta",
						"additionalProperties": false,
						"required": [
							"report",
							"currency",
							"category",
							"side",
							"period",
							"generatedAt"
						],
						"properties": {
							"report": {
								"type": "string",
								"enum": [
									"resultsDetail"
								]
							},
							"currency": {
								"type": "string",
								"description": "Moneda de la empresa (ISO 4217), la de todos los importes"
							},
							"category": {
								"type": "string",
								"enum": [
									"invoices",
									"currencyGains",
									"otherIncome",
									"bills",
									"payrolls",
									"depreciation",
									"currencyLosses",
									"otherExpenses"
								]
							},
							"side": {
								"type": "string",
								"enum": [
									"income",
									"expenses"
								]
							},
							"period": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"start",
									"end"
								],
								"properties": {
									"start": {
										"type": "string",
										"format": "date"
									},
									"end": {
										"type": "string",
										"format": "date"
									}
								}
							},
							"generatedAt": {
								"type": "string",
								"format": "date-time"
							}
						}
					},
					"items": {
						"type": "array",
						"items": {
							"type": "object",
							"title": "ResultsDetailReportItem",
							"additionalProperties": false,
							"required": [
								"id",
								"type",
								"title",
								"date",
								"amount"
							],
							"properties": {
								"id": {
									"type": "string",
									"description": "Identificador del documento que genera los apuntes (`inv_...`, `bil_...`, `par_...`, `tra_...`)"
								},
								"type": {
									"type": "string",
									"nullable": true,
									"description": "Tipo del documento (`invoice`, `bill`, `payroll`, `transaction`...)"
								},
								"title": {
									"type": "string",
									"nullable": true,
									"description": "Título del documento"
								},
								"date": {
									"type": "string",
									"format": "date",
									"description": "Fecha del primer apunte del documento en el periodo"
								},
								"amount": {
									"type": "number",
									"description": "Importe que el documento aporta a la categoría en el periodo, con el signo de su lado: positivo si suma a los ingresos o a los gastos"
								}
							}
						}
					},
					"pagination": {
						"$ref": "#/components/schemas/Pagination"
					}
				}
			},
			"ResultsSummaryReport": {
				"type": "object",
				"title": "ResultsSummaryReport",
				"additionalProperties": false,
				"required": [
					"meta",
					"rows"
				],
				"properties": {
					"meta": {
						"type": "object",
						"title": "ResultsSummaryReportMeta",
						"additionalProperties": false,
						"required": [
							"report",
							"currency",
							"columns",
							"generatedAt"
						],
						"properties": {
							"report": {
								"type": "string",
								"enum": [
									"resultsSummary"
								]
							},
							"currency": {
								"type": "string",
								"description": "Moneda de la empresa (ISO 4217), la de todos los importes"
							},
							"columns": {
								"type": "array",
								"items": {
									"$ref": "#/components/schemas/ReportColumn"
								}
							},
							"generatedAt": {
								"type": "string",
								"format": "date-time",
								"description": "Momento en que se calculó el informe"
							}
						}
					},
					"rows": {
						"type": "array",
						"description": "Categorías de ingresos con importe en algún periodo, total de ingresos, categorías de gastos, total de gastos y beneficio. Los tres totales aparecen siempre.",
						"items": {
							"type": "object",
							"title": "ResultsSummaryReportRow",
							"additionalProperties": false,
							"required": [
								"id",
								"kind",
								"title",
								"values"
							],
							"properties": {
								"id": {
									"type": "string",
									"enum": [
										"invoices",
										"currencyGains",
										"otherIncome",
										"bills",
										"payrolls",
										"depreciation",
										"currencyLosses",
										"otherExpenses",
										"income",
										"expenses",
										"profit"
									],
									"description": "Origen de los importes:\n\n* invoices: Ventas facturadas\n* currencyGains: Diferencias de cambio a favor\n* otherIncome: Otros ingresos\n* bills: Compras y gastos\n* payrolls: Nóminas\n* depreciation: Amortizaciones\n* currencyLosses: Diferencias de cambio en contra\n* otherExpenses: Otros gastos\n\nEn los totales: `income` (total de ingresos), `expenses` (total de gastos) y `profit` (beneficio: ingresos menos gastos)."
								},
								"kind": {
									"type": "string",
									"enum": [
										"category",
										"total"
									]
								},
								"side": {
									"type": "string",
									"enum": [
										"income",
										"expenses"
									],
									"description": "Lado de una categoría: ingresos o gastos"
								},
								"title": {
									"type": "string",
									"description": "Nombre de la fila en el idioma de la petición"
								},
								"values": {
									"type": "object",
									"description": "Valor de cada columna por su `id`: importe en euros para los periodos y la diferencia, fracción para la variación (`null` si la referencia es cero)",
									"additionalProperties": {
										"type": "number",
										"nullable": true
									}
								}
							}
						}
					}
				}
			},
			"SalesTax": {
				"type": "object",
				"title": "SalesTax",
				"description": "Impuesto de venta",
				"required": [
					"id",
					"taxGroup",
					"value",
					"account",
					"title",
					"shortTitle",
					"current",
					"country",
					"selectorFlags"
				],
				"additionalProperties": false,
				"properties": {
					"id": {
						"type": "string"
					},
					"taxGroup": {
						"type": "string",
						"description": "Grupo de impuestos.\n\n  No se debe asumir que siempre van a existir estos valores, si hay cambios normativos pueden definirse nuevos valores en cualquier momento.\n\n  Los grupos disponibles en cada empresas pueden ser distintos según su dirección fiscal.\n  \n  * IVA: IVA\n  * IVA_RE: IVA de recargo de equivalencia\n  * IGIC: Impuesto General Indirecto Canario (Canarias)\n  * IPSI: Impuesto sobre la Producción, los Servicios y la Importación (Ceuta y Melilla)\n  * IRPF: Retención de IRPF\n  * VATEU: IVA de países de la EU distintos de España (IVA declarado en dichos países)\n  ",
						"enum": [
							"IVA",
							"IVA_RE",
							"IGIC",
							"IPSI",
							"IRPF",
							"VATEU"
						]
					},
					"value": {
						"type": "number",
						"description": "Porcentaje del impuesto en base 1.\n\nValor: 0.21 para IVA 21%"
					},
					"account": {
						"$ref": "#/components/schemas/AccountCode"
					},
					"title": {
						"type": "string",
						"description": "Nombre completo del impuesto"
					},
					"shortTitle": {
						"type": "string",
						"description": "Nombre corto del impuesto"
					},
					"current": {
						"type": "boolean",
						"description": "Indica si es un impuesto vigente actualmente"
					},
					"country": {
						"type": "string",
						"description": "País de recaudación del impuesto (Formato ISO 3166-1 Alpha-2)"
					},
					"category": {
						"type": "string",
						"description": "Categoría funcional del impuesto. Permite agrupar y filtrar los impuestos por su función en el sistema fiscal.\n\nNo se debe asumir que siempre van a existir estos valores, si hay cambios normativos pueden definirse nuevos valores en cualquier momento.\n\n* standard_vat: IVA/IGIC/IPSI estándar (tipos normal, reducido, superreducido y temporales)\n* exempt_vat: Operación exenta de IVA/IGIC\n* intra_community: Operación intracomunitaria. En compras se genera automáticamente un par autorepercutido (efecto neto cero)\n* reverse_charge: Inversión del sujeto pasivo. El comprador liquida el impuesto en lugar del vendedor\n* equivalence_surcharge: Recargo de equivalencia (régimen especial de comerciantes minoristas)\n* withholding: Retención de IRPF a cuenta del impuesto sobre la renta del perceptor\n* rental_withholding: Retención de IRPF por alquiler de inmueble urbano\n* pass_through: Suplidos: gastos pagados en nombre de un tercero, sin IVA\n* export: Exportación a país fuera de la UE\n* eu_consumer_vat: IVA del país de destino para ventas a consumidores finales de la UE (régimen OSS)\n",
						"enum": [
							"standard_vat",
							"exempt_vat",
							"intra_community",
							"reverse_charge",
							"equivalence_surcharge",
							"withholding",
							"rental_withholding",
							"pass_through",
							"export",
							"eu_consumer_vat"
						]
					},
					"description": {
						"type": "string",
						"description": "Explicación breve, en español, del propósito y funcionamiento de este impuesto. Orientada a ayudar al integrador a elegir el impuesto correcto para cada operación."
					},
					"selectorFlags": {
						"type": "array",
						"description": "Indica dónde puede el usuario aplicar este impuesto:\n\n* product: Puede asignarse a un producto del catálogo como impuesto por defecto.\n* line: Puede aplicarse en líneas de documentos (facturas, presupuestos, gastos, etc.).\n\nUn array vacío indica un impuesto que no se selecciona manualmente. Es el caso de los impuestos autorepercutidos: se aplican automáticamente cuando se usa su impuesto pareja (ver `pairedWith` y `autoApplied`).",
						"items": {
							"type": "string",
							"enum": [
								"product",
								"line"
							]
						}
					},
					"autoApplied": {
						"type": "boolean",
						"description": "Si es `true`, este impuesto se aplica automáticamente cuando se usa el impuesto referenciado en `pairedWith`. El usuario no lo selecciona directamente.\n\nEs el mecanismo de los impuestos autorepercutidos: en compras intracomunitarias, inversión del sujeto pasivo o importación de servicios extracomunitarios, el sistema genera un par de impuestos (uno deducible y otro devengado) cuyo efecto neto es cero pero ambos deben quedar reflejados en la declaración."
					},
					"pairedWith": {
						"type": "string",
						"description": "Identificador del impuesto pareja al que está vinculado este impuesto.\n\n* En el impuesto base (no autorepercutido) apunta al impuesto autorepercutido que se generará automáticamente cuando se aplique.\n* En el impuesto autorepercutido (`autoApplied: true`) apunta al impuesto base que dispara su aplicación automática."
					}
				}
			},
			"SearchResultItem": {
				"type": "object",
				"title": "SearchResultItem",
				"additionalProperties": false,
				"required": [
					"type",
					"resource",
					"id",
					"title",
					"displayType"
				],
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"contact",
							"invoice",
							"estimate",
							"deliveryNote",
							"clientOrder",
							"purchaseOrder",
							"bill",
							"payroll",
							"product",
							"automation"
						],
						"description": "Tipo de documento"
					},
					"resource": {
						"type": "string",
						"enum": [
							"contacts",
							"invoices",
							"estimates",
							"deliveryNotes",
							"clientOrders",
							"purchaseOrders",
							"bills",
							"payrolls",
							"products",
							"recurring"
						],
						"description": "Recurso de la API con el que se lee el documento (`GET /{companyId}/<resource>/{id}`; `recurring` es `GET /{companyId}/recurring/invoices/{id}`)"
					},
					"id": {
						"type": "string"
					},
					"title": {
						"type": "string",
						"description": "Lo que identifica el documento: número de factura, presupuesto, albarán, pedido u orden; nombre del contacto; proveedor de la factura de compra; empleado de la nómina; título del producto o de la factura recurrente"
					},
					"subtitle": {
						"type": "string",
						"description": "Contacto del documento, NIF y email del contacto, referencia del producto, referencia de la factura de compra o título de la nómina"
					},
					"snippet": {
						"type": "string",
						"description": "Fragmento del texto del documento alrededor de la palabra buscada que coincide (una línea, una nota…), cuando la coincidencia no está ya en `title` ni en `subtitle`"
					},
					"date": {
						"type": "string",
						"format": "date"
					},
					"total": {
						"type": "number"
					},
					"currency": {
						"type": "string"
					},
					"displayType": {
						"type": "string",
						"description": "Tipo tal como se muestra: `ticket` en las facturas de compra que son tickets; el tipo en el resto"
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"StatementContent": {
				"type": "object",
				"title": "StatementContent",
				"description": "Contenido de un extracto bancario",
				"required": [
					"uuid",
					"date",
					"title",
					"amount",
					"currency",
					"state",
					"bank",
					"ignore"
				],
				"properties": {
					"uuid": {
						"type": "string",
						"description": "Identificador del extracto bancario"
					},
					"date": {
						"type": "string",
						"format": "date",
						"description": "Fecha de la operación"
					},
					"title": {
						"type": "string",
						"description": "Concepto del movimiento"
					},
					"amount": {
						"type": "number",
						"description": "Importe del movimiento. Positivo para ingresos, negativo para cargos"
					},
					"currency": {
						"type": "string",
						"description": "Moneda del movimiento (Formato ISO 4217)"
					},
					"companyCurrencyAmount": {
						"type": "number",
						"description": "Importe convertido a la moneda de la empresa"
					},
					"balance": {
						"type": "number",
						"nullable": true,
						"description": "Saldo disponible de la cuenta tras el movimiento, según la entidad. Positivo es dinero en el banco. Null si el movimiento no lo trae (importado sin saldo, o banco de Stripe)"
					},
					"bookedBalance": {
						"type": "number",
						"nullable": true,
						"description": "Saldo contable de la cuenta tras el movimiento, según la entidad, cuando difiere del disponible. Null si la entidad no lo informa"
					},
					"state": {
						"type": "string",
						"enum": [
							"pending",
							"reconciled",
							"ignored"
						]
					},
					"bank": {
						"type": "string",
						"description": "Identificador del banco asociado"
					},
					"notes": {
						"type": "string",
						"nullable": true
					},
					"ignore": {
						"type": "boolean"
					},
					"matchedDocument": {
						"type": "string",
						"nullable": true,
						"description": "Identificador del documento conciliado"
					},
					"sourceKey": {
						"type": "string",
						"nullable": true
					}
				}
			},
			"StatementListItem": {
				"type": "object",
				"title": "StatementListItem",
				"description": "Extracto bancario en una lista de resultados",
				"additionalProperties": false,
				"required": [
					"uuid",
					"date",
					"title",
					"amount",
					"currency",
					"state",
					"bank",
					"ignore",
					"creationDate",
					"modificationDate"
				],
				"properties": {
					"uuid": {
						"type": "string",
						"description": "Identificador del extracto bancario"
					},
					"date": {
						"type": "string",
						"format": "date",
						"description": "Fecha de la operación"
					},
					"title": {
						"type": "string",
						"description": "Concepto del movimiento"
					},
					"amount": {
						"type": "number",
						"description": "Importe del movimiento. Positivo para ingresos, negativo para cargos"
					},
					"currency": {
						"type": "string",
						"description": "Moneda del movimiento (Formato ISO 4217)"
					},
					"companyCurrencyAmount": {
						"type": "number",
						"description": "Importe convertido a la moneda de la empresa"
					},
					"balance": {
						"type": "number",
						"nullable": true,
						"description": "Saldo disponible de la cuenta tras el movimiento, según la entidad. Positivo es dinero en el banco. Null si el movimiento no lo trae (importado sin saldo, o banco de Stripe)"
					},
					"bookedBalance": {
						"type": "number",
						"nullable": true,
						"description": "Saldo contable de la cuenta tras el movimiento, según la entidad, cuando difiere del disponible. Null si la entidad no lo informa"
					},
					"state": {
						"type": "string",
						"enum": [
							"pending",
							"reconciled",
							"ignored"
						],
						"description": "Estado de conciliación del extracto bancario:\n* pending: Pendiente de conciliar\n* reconciled: Conciliado con un documento\n* ignored: Marcado como ignorado"
					},
					"bank": {
						"type": "string",
						"description": "Identificador del banco asociado"
					},
					"bankTitle": {
						"type": "string",
						"description": "Nombre del banco asociado"
					},
					"notes": {
						"type": "string",
						"nullable": true,
						"description": "Notas del extracto bancario"
					},
					"ignore": {
						"type": "boolean",
						"description": "Indica si el extracto está marcado como ignorado"
					},
					"matchedDocument": {
						"type": "string",
						"nullable": true,
						"description": "Identificador del documento conciliado"
					},
					"matchedDocumentTitle": {
						"type": "string",
						"nullable": true,
						"description": "Título del documento conciliado"
					},
					"sourceKey": {
						"type": "string",
						"nullable": true,
						"description": "Identificador del origen de importación"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					}
				}
			},
			"StatementResponse": {
				"type": "object",
				"title": "StatementResponse",
				"description": "Detalle de un extracto bancario",
				"additionalProperties": false,
				"required": [
					"content",
					"creationDate",
					"modificationDate"
				],
				"properties": {
					"content": {
						"$ref": "#/components/schemas/StatementContent"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					}
				}
			},
			"Tags": {
				"type": "array",
				"title": "Tags",
				"description": "Etiquetas del documento",
				"items": {
					"type": "string"
				}
			},
			"TagsOperation": {
				"type": "string",
				"title": "TagsOperation",
				"description": "Tipo de operación con las etiquetas del documento. Es obligatorio si se indica el elemento 'tags' y la operación es de actualización",
				"enum": [
					"add",
					"remove",
					"replace"
				]
			},
			"TaxDeclaration": {
				"type": "object",
				"title": "TaxDeclaration",
				"description": "Un modelo de impuestos generado y guardado en FacturaDirecta. El sobre (todo menos `boxes` y `records`) es estable y solo crece; `boxes` y `records` siguen el diseño de registro de la AEAT que indica `formVersion`.",
				"required": [
					"id",
					"form",
					"kind",
					"fiscalYear",
					"fiscalPeriod",
					"periodStart",
					"periodEnd",
					"generatedAt",
					"formVersion",
					"result",
					"status",
					"filing",
					"origin",
					"aeatFile",
					"attachmentsCount"
				],
				"additionalProperties": false,
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador opaco y estable del modelo. Formado por el prefijo `tax_` y un uuid v4."
					},
					"form": {
						"type": "string",
						"enum": [
							"111",
							"115",
							"130",
							"180",
							"190",
							"202",
							"303",
							"347",
							"349",
							"390"
						],
						"description": "Número del modelo de la AEAT. Conjunto abierto: pueden añadirse modelos."
					},
					"kind": {
						"type": "string",
						"enum": [
							"selfAssessment",
							"informative"
						],
						"description": "`selfAssessment` en las autoliquidaciones (303, 111, 115, 130, 202), que liquidan un importe; `informative` en las declaraciones informativas (180, 190, 347, 349, 390), que no."
					},
					"fiscalYear": {
						"type": "integer",
						"description": "Ejercicio."
					},
					"fiscalPeriod": {
						"type": "string",
						"nullable": true,
						"enum": [
							"1T",
							"2T",
							"3T",
							"4T",
							"01",
							"02",
							"03",
							"04",
							"05",
							"06",
							"07",
							"08",
							"09",
							"10",
							"11",
							"12",
							"1P",
							"2P",
							"3P",
							null
						],
						"description": "Periodo: trimestre (`1T`…`4T`), mes (`01`…`12`) o pago fraccionado del 202 (`1P`…`3P`). `null` en los modelos anuales."
					},
					"periodStart": {
						"type": "string",
						"format": "date",
						"description": "Primer día del periodo declarado."
					},
					"periodEnd": {
						"type": "string",
						"format": "date",
						"description": "Último día del periodo declarado. En el 202 y en los anuales, el ejercicio entero."
					},
					"generatedAt": {
						"type": "string",
						"format": "date-time",
						"nullable": true,
						"description": "Momento en que se calcularon las casillas. Si el usuario regenera el modelo, cambia."
					},
					"formVersion": {
						"type": "string",
						"description": "Diseño de registro de la AEAT aplicado, por ejemplo `303_e26v101`. Para un valor dado las casillas no cambian nunca; un diseño nuevo de la AEAT es un valor nuevo."
					},
					"result": {
						"$ref": "#/components/schemas/TaxDeclarationResult"
					},
					"status": {
						"type": "string",
						"enum": [
							"generated"
						],
						"description": "Estado del modelo. Hoy siempre `generated`: FacturaDirecta no registra la presentación. Conjunto abierto: llegarán otros valores (como `filed`) sin cambiar la versión de la API."
					},
					"filing": {
						"type": "object",
						"nullable": true,
						"additionalProperties": true,
						"description": "Datos de presentación (fecha, CSV, NRC, canal). Hoy nada los registra y el valor es siempre `null`; el campo existe para que, cuando se registren, el contrato no cambie."
					},
					"origin": {
						"type": "string",
						"enum": [
							"facturadirecta"
						],
						"description": "Dónde se generó el modelo. Conjunto abierto."
					},
					"aeatFile": {
						"$ref": "#/components/schemas/TaxDeclarationAeatFile"
					},
					"attachmentsCount": {
						"type": "integer",
						"description": "Número de adjuntos del modelo (`GET /{companyId}/taxDeclarations/{id}/attachments`), como el justificante de presentación si el usuario lo adjuntó."
					},
					"boxes": {
						"type": "array",
						"description": "Casillas del modelo tal como se escriben en el fichero de presentación de la AEAT, en el orden del diseño de registro, también las que valen cero. No incluye el relleno técnico del fichero, la identidad de la empresa (ver `/settings/company`) ni los registros por tercero (ver `records`). El IBAN de domiciliación o devolución va enmascarado salvo con el scope `banks:readIban`. Siempre en el detalle; en el listado, con `related=boxes`.",
						"items": {
							"$ref": "#/components/schemas/TaxDeclarationBox"
						}
					},
					"records": {
						"$ref": "#/components/schemas/TaxDeclarationRecords"
					}
				}
			},
			"TaxDeclarationAeatFile": {
				"type": "object",
				"title": "TaxDeclarationAeatFile",
				"required": [
					"available",
					"filename"
				],
				"additionalProperties": false,
				"properties": {
					"available": {
						"type": "boolean",
						"description": "Si el modelo tiene fichero de presentación. El 390 se rellena en la Sede de la AEAT y no lo tiene."
					},
					"filename": {
						"type": "string",
						"nullable": true,
						"description": "Nombre del fichero que devuelve `PUT /{companyId}/taxDeclarations/{id}/aeatFile`."
					}
				}
			},
			"TaxDeclarationBox": {
				"type": "object",
				"title": "TaxDeclarationBox",
				"required": [
					"key",
					"title",
					"value"
				],
				"additionalProperties": false,
				"properties": {
					"key": {
						"type": "string",
						"description": "Número oficial de la casilla (`27`, `71`) o clave de control del diseño de registro (`tipoDeclaracion`, `iban`, `ejercicio`, `periodo`). Dentro de una `formVersion` las claves no cambian."
					},
					"title": {
						"type": "string",
						"description": "Descripción de la casilla en el formulario. Es texto de ayuda, no contrato: puede corregirse sin cambiar de versión."
					},
					"value": {
						"description": "Importe en las casillas numéricas; código o texto en las demás.",
						"oneOf": [
							{
								"type": "number"
							},
							{
								"type": "string"
							}
						]
					}
				}
			},
			"TaxDeclarationRecords": {
				"type": "object",
				"title": "TaxDeclarationRecords",
				"nullable": true,
				"description": "Registros por tercero de una declaración informativa: los declarados del 347, los operadores intracomunitarios del 349 y los perceptores del 180 y del 190. Son los registros de tipo 2 del fichero de la AEAT. Solo en el detalle, con `related=records`; `null` en los modelos que no los tienen.",
				"required": [
					"fields",
					"items"
				],
				"additionalProperties": false,
				"properties": {
					"fields": {
						"type": "array",
						"description": "Campos de cada registro, en el orden del diseño de registro.",
						"items": {
							"type": "object",
							"title": "TaxDeclarationRecordField",
							"required": [
								"key",
								"title"
							],
							"additionalProperties": false,
							"properties": {
								"key": {
									"type": "string"
								},
								"title": {
									"type": "string"
								}
							}
						}
					},
					"items": {
						"type": "array",
						"description": "Un elemento por tercero, con el valor de cada campo bajo su `key`.",
						"items": {
							"type": "object",
							"additionalProperties": {
								"description": "Importe en las casillas numéricas; código o texto en las demás.",
								"oneOf": [
									{
										"type": "number"
									},
									{
										"type": "string"
									}
								]
							}
						}
					}
				}
			},
			"TaxDeclarationResponse": {
				"type": "object",
				"title": "TaxDeclarationResponse",
				"required": [
					"content",
					"tags",
					"creationDate",
					"modificationDate"
				],
				"additionalProperties": false,
				"properties": {
					"content": {
						"$ref": "#/components/schemas/TaxDeclaration"
					},
					"tags": {
						"$ref": "#/components/schemas/Tags"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					},
					"related": {
						"type": "object",
						"title": "TaxDeclarationRelated",
						"additionalProperties": false,
						"properties": {
							"journal": {
								"type": "array",
								"description": "Asiento contable del modelo (el devengo de la liquidación: cuentas 477, 472, 475 y 470), con la forma reducida de las entradas de `GET /{companyId}/journal`. Vacío en las declaraciones informativas, que no generan asiento.",
								"items": {
									"$ref": "#/components/schemas/RelatedJournalEntry"
								}
							}
						}
					},
					"webUrl": {
						"$ref": "#/components/schemas/WebUrl"
					}
				}
			},
			"TaxDeclarationResult": {
				"type": "object",
				"title": "TaxDeclarationResult",
				"required": [
					"amount",
					"currency",
					"declarationType"
				],
				"additionalProperties": false,
				"properties": {
					"amount": {
						"type": "number",
						"nullable": true,
						"description": "Resultado de la autoliquidación en la moneda de la empresa: positivo a ingresar, negativo a compensar o devolver. `null` en las declaraciones informativas."
					},
					"currency": {
						"type": "string",
						"description": "Moneda de la empresa (ISO 4217)."
					},
					"declarationType": {
						"type": "string",
						"nullable": true,
						"description": "Código del tipo de declaración de la AEAT en los modelos que lo tienen: `I` ingreso, `U` domiciliación, `G` cuenta corriente tributaria (ingreso), `C` compensación, `D` devolución, `V` cuenta corriente tributaria (devolución), `N` sin actividad o resultado cero. Conjunto abierto."
					}
				}
			},
			"TaxDefinition": {
				"type": "object",
				"title": "TaxDefinition",
				"required": [
					"type",
					"id",
					"title",
					"value",
					"taxGroup"
				],
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"taxDefinition"
						]
					},
					"id": {
						"$ref": "#/components/schemas/TaxId"
					},
					"title": {
						"type": "string"
					},
					"value": {
						"type": "number"
					},
					"current": {
						"type": "boolean"
					},
					"taxGroup": {
						"type": "string",
						"enum": [
							"IVA",
							"VATEU",
							"IRPF",
							"IPSI",
							"IGIC",
							"IVA_RE",
							"OTHER"
						]
					}
				}
			},
			"TaxId": {
				"type": "string",
				"title": "TaxId",
				"description": "Identificador interno de un impuesto"
			},
			"Transaction": {
				"type": "object",
				"title": "Transaction",
				"additionalProperties": false,
				"required": [
					"main",
					"type",
					"uuid",
					"accounting"
				],
				"properties": {
					"uuid": {
						"type": "string"
					},
					"type": {
						"enum": [
							"transaction"
						]
					},
					"accounting": {
						"$ref": "#/components/schemas/Accounting"
					},
					"attachments": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/Attachment"
						}
					},
					"import": {
						"$ref": "#/components/schemas/ImportInformation"
					},
					"main": {
						"type": "object",
						"additionalProperties": false,
						"required": [
							"date"
						],
						"properties": {
							"date": {
								"type": "string",
								"format": "date",
								"nullable": true
							},
							"title": {
								"type": "string"
							},
							"contact": {
								"type": "string"
							},
							"account": {
								"$ref": "#/components/schemas/AccountCode"
							},
							"currency": {
								"type": "string"
							},
							"bank": {
								"type": "string"
							},
							"bankBalance": {
								"type": "number"
							},
							"bankManual": {
								"type": "boolean"
							},
							"subtype": {
								"enum": [
									"send",
									"receive",
									"other"
								]
							},
							"notes": {
								"type": "string"
							},
							"externalTransactionId": {
								"type": "string"
							}
						}
					},
					"meta": {
						"type": "object",
						"title": "TransactionMeta",
						"description": "Metadatos internos del asiento",
						"additionalProperties": false,
						"properties": {
							"automationSource": {
								"type": "string"
							}
						},
						"readOnly": true
					}
				}
			},
			"TrialBalanceAmounts": {
				"type": "object",
				"title": "TrialBalanceAmounts",
				"additionalProperties": false,
				"required": [
					"previousBalance",
					"debit",
					"credit",
					"balance"
				],
				"properties": {
					"previousBalance": {
						"type": "number",
						"description": "Saldo anterior al periodo (debe menos haber)"
					},
					"debit": {
						"type": "number",
						"description": "Debe del periodo"
					},
					"credit": {
						"type": "number",
						"description": "Haber del periodo"
					},
					"balance": {
						"type": "number",
						"description": "Saldo final: saldo anterior más debe menos haber"
					}
				}
			},
			"TrialBalanceReport": {
				"type": "object",
				"title": "TrialBalanceReport",
				"additionalProperties": false,
				"required": [
					"meta",
					"rows",
					"totals",
					"pagination"
				],
				"properties": {
					"meta": {
						"type": "object",
						"title": "TrialBalanceReportMeta",
						"additionalProperties": false,
						"required": [
							"report",
							"currency",
							"period",
							"groups",
							"thirdPartyDetail",
							"policies",
							"generatedAt"
						],
						"properties": {
							"report": {
								"type": "string",
								"enum": [
									"trialBalance"
								]
							},
							"currency": {
								"type": "string",
								"description": "Moneda de la empresa (ISO 4217)"
							},
							"period": {
								"type": "object",
								"additionalProperties": false,
								"properties": {
									"start": {
										"type": "string",
										"format": "date"
									},
									"end": {
										"type": "string",
										"format": "date"
									}
								}
							},
							"groups": {
								"type": "array",
								"items": {
									"type": "integer",
									"enum": [
										1,
										2,
										3
									]
								}
							},
							"thirdPartyDetail": {
								"type": "boolean"
							},
							"policies": {
								"type": "object",
								"additionalProperties": false,
								"required": [
									"includeClosure",
									"excludeRevenueClearing"
								],
								"properties": {
									"includeClosure": {
										"type": "boolean"
									},
									"excludeRevenueClearing": {
										"type": "boolean"
									},
									"tags": {
										"type": "array",
										"items": {
											"type": "string"
										}
									}
								}
							},
							"generatedAt": {
								"type": "string",
								"format": "date-time"
							}
						}
					},
					"rows": {
						"type": "array",
						"items": {
							"type": "object",
							"title": "TrialBalanceReportRow",
							"additionalProperties": false,
							"required": [
								"id",
								"kind",
								"level",
								"title",
								"amounts"
							],
							"properties": {
								"id": {
									"type": "string",
									"description": "Identificador de la fila: la cuenta (`430000`), el subtotal (`group/43`) o la cuenta y el tercero (`430000/con_...`, `430000/unclassified` para los apuntes sin tercero); con `showCurrency` se añade `@` y la moneda"
								},
								"kind": {
									"type": "string",
									"enum": [
										"group",
										"account",
										"thirdParty"
									]
								},
								"level": {
									"type": "integer",
									"description": "Nivel de sangría, el de la web"
								},
								"title": {
									"type": "string"
								},
								"accountPrefix": {
									"type": "string",
									"description": "Prefijo de cuenta de un subtotal"
								},
								"account": {
									"type": "string"
								},
								"accountTitle": {
									"type": "string"
								},
								"thirdParty": {
									"type": "object",
									"nullable": true,
									"additionalProperties": false,
									"required": [
										"id",
										"type",
										"name"
									],
									"description": "Tercero de una fila `thirdParty`; `null` para los apuntes de la cuenta sin tercero",
									"properties": {
										"id": {
											"type": "string"
										},
										"type": {
											"type": "string",
											"nullable": true
										},
										"name": {
											"type": "string",
											"nullable": true
										}
									}
								},
								"currency": {
									"type": "string",
									"description": "Moneda de la fila, con `showCurrency`"
								},
								"amounts": {
									"$ref": "#/components/schemas/TrialBalanceAmounts"
								},
								"currencyAmounts": {
									"$ref": "#/components/schemas/TrialBalanceAmounts"
								}
							}
						}
					},
					"totals": {
						"$ref": "#/components/schemas/TrialBalanceAmounts"
					},
					"pagination": {
						"$ref": "#/components/schemas/Pagination"
					}
				}
			},
			"UnreconcileStatementResponse": {
				"type": "object",
				"title": "UnreconcileStatementResponse",
				"description": "Resultado de la desconciliación de un extracto bancario",
				"additionalProperties": false,
				"required": [
					"content",
					"creationDate",
					"modificationDate"
				],
				"properties": {
					"content": {
						"$ref": "#/components/schemas/StatementContent"
					},
					"archivedTransaction": {
						"type": "string",
						"nullable": true,
						"description": "Identificador del asiento contable archivado. Solo presente cuando se usa deleteTransaction=true"
					},
					"creationDate": {
						"$ref": "#/components/schemas/CreationDate"
					},
					"modificationDate": {
						"$ref": "#/components/schemas/ModificationDate"
					}
				}
			},
			"WebhookEndpoint": {
				"type": "object",
				"title": "WebhookEndpoint",
				"additionalProperties": false,
				"required": [
					"id",
					"name",
					"url",
					"events",
					"enabled",
					"warning",
					"livemode"
				],
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador único del endpoint"
					},
					"name": {
						"type": "string",
						"description": "Nombre descriptivo del endpoint"
					},
					"url": {
						"type": "string",
						"description": "URL de destino del webhook"
					},
					"events": {
						"type": "array",
						"items": {
							"type": "string"
						},
						"description": "Lista de tipos de eventos suscritos"
					},
					"enabled": {
						"type": "boolean",
						"description": "Indica si el endpoint está activo"
					},
					"warning": {
						"type": "boolean",
						"description": "Indica si el endpoint está en estado de alerta por fallos continuos"
					},
					"livemode": {
						"type": "boolean",
						"description": "Indica si el endpoint opera en modo real (true) o sandbox (false)"
					}
				}
			},
			"WebhookEvent": {
				"type": "object",
				"title": "WebhookEvent",
				"additionalProperties": true,
				"required": [
					"id",
					"type",
					"endpoint_id",
					"status",
					"created_at"
				],
				"properties": {
					"id": {
						"type": "string",
						"description": "Identificador único del evento"
					},
					"type": {
						"type": "string",
						"description": "Tipo de evento (ej. invoice.created)"
					},
					"endpoint_id": {
						"type": "string",
						"description": "ID del endpoint al que pertenece el evento"
					},
					"endpoint_url": {
						"type": "string",
						"description": "URL del endpoint al que se envió el evento"
					},
					"status": {
						"type": "string",
						"description": "Estado del evento (pending, delivered, failed)"
					},
					"created_at": {
						"type": "string",
						"description": "Fecha de creación del evento (ISO 8601)"
					}
				}
			},
			"WebUrl": {
				"type": "string",
				"format": "uri",
				"title": "WebUrl",
				"description": "URL de detalle del elemento en la aplicación web de FacturaDirecta, para enlazarlo o abrirlo en el navegador (pide iniciar sesión con un usuario de la empresa). No es un endpoint de la API.",
				"example": "https://3.facturadirecta.com/company/com_4d8f0a6e-1b2c-4c3d-9e8f-0a1b2c3d4e5f/doc/inv_7c9e6679-7425-40de-944b-e07fc1f90ae7"
			}
		},
		"responses": {
			"UnauthorizedError": {
				"description": "Respuesta de error cuando no se intenta realizar una operación sin la información de autorización o con información de autorización incorrecta, como por ejemplo un token oAuth caducado.",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "UnauthorizedErrorResponse",
							"required": [
								"statusCode",
								"message"
							],
							"additionalProperties": false,
							"properties": {
								"statusCode": {
									"type": "integer",
									"enum": [
										401
									]
								},
								"message": {
									"type": "string"
								}
							}
						}
					}
				}
			},
			"ForbiddenError": {
				"description": "Respuesta de error cuando se intenta realizar una operación para la que el usuario no tiene permiso, bien sea por su rol dentro del programa o por el scope seleccionado en la identificacón de la API.",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "ForbiddenErrorResponse",
							"required": [
								"statusCode",
								"message"
							],
							"additionalProperties": false,
							"properties": {
								"statusCode": {
									"type": "integer",
									"enum": [
										403
									]
								},
								"message": {
									"type": "string"
								}
							}
						}
					}
				}
			},
			"NotFoundError": {
				"description": "Respuesta de error cuando no se encuentra un documento en una consulta o actualización",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "NotFoundErrorResponse",
							"required": [
								"statusCode",
								"message"
							],
							"additionalProperties": false,
							"properties": {
								"statusCode": {
									"type": "integer",
									"enum": [
										404
									]
								},
								"message": {
									"type": "string"
								}
							}
						}
					}
				}
			},
			"BadRequestError": {
				"description": "Respuesta de error cuando no se envía una petición con parámetros o formato incorrecto",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "BadRequestErrorResponse",
							"required": [
								"statusCode",
								"message"
							],
							"additionalProperties": false,
							"properties": {
								"statusCode": {
									"type": "integer",
									"enum": [
										400
									]
								},
								"message": {
									"type": "string"
								},
								"type": {
									"type": "string"
								},
								"errors": {
									"type": "array",
									"items": {
										"type": "object",
										"additionalProperties": true
									}
								}
							}
						}
					}
				}
			},
			"ConflictError": {
				"description": "Respuesta de error cuando no se puede realizar la operación por un conflicto con el estado del recurso o por discordancia entre la URL de la petición y el contenido de la misma.\n      \nEjemplo: Cuado intentamos crear un documento indicando un ID de otro que ya existe\n\nEn las operaciones que admiten la cabecera `Idempotency-Key` también se devuelve, con un código en `errors[0].code`, cuando hay otra petición en curso con la misma clave (`idempotency_key_in_use`, con cabecera `Retry-After`) o cuando la petición original se completó pero su respuesta no se conserva (`idempotency_result_not_replayable`, con el recurso creado en `errors[0].resource`).",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "ConflictErrorResponse",
							"required": [
								"statusCode",
								"message"
							],
							"additionalProperties": false,
							"properties": {
								"statusCode": {
									"type": "integer",
									"enum": [
										409
									]
								},
								"message": {
									"type": "string"
								},
								"errors": {
									"type": "array",
									"items": {
										"type": "object",
										"additionalProperties": true
									}
								}
							}
						}
					}
				}
			},
			"InternalServerError": {
				"description": "Respuesta de error cuando se produce un error inesperado en el servidor.\n      \nSi recibes este error, por favor contacta con el soporte de FacturaDirecta",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "InternalServerError",
							"required": [
								"statusCode",
								"message"
							],
							"additionalProperties": false,
							"properties": {
								"statusCode": {
									"type": "integer",
									"enum": [
										500
									]
								},
								"message": {
									"type": "string"
								}
							}
						}
					}
				}
			},
			"DeleteResponse": {
				"description": "Resultado de borrado de un elemento",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "DeleteResponse",
							"required": [
								"result"
							],
							"additionalProperties": false,
							"properties": {
								"result": {
									"type": "boolean"
								}
							}
						}
					}
				}
			},
			"SendInvoiceResponse": {
				"description": "Resultado del envío de una factura",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "SendInvoiceResponse",
							"required": [
								"from",
								"to",
								"sentFacturae"
							],
							"additionalProperties": false,
							"properties": {
								"from": {
									"type": "string",
									"description": "Remitente usado para el envío"
								},
								"to": {
									"type": "array",
									"description": "Destinatario al que se ha enviado el documento",
									"items": {
										"type": "string"
									}
								},
								"cc": {
									"type": "array",
									"description": "Destinatario al que se ha enviado en copia visible el documento",
									"items": {
										"type": "string"
									}
								},
								"bcc": {
									"type": "array",
									"description": "Destinatarios al que se ha enviado en copia oculta el documento",
									"items": {
										"type": "string"
									}
								},
								"sentFacturae": {
									"type": "boolean",
									"description": "Indica si se ha incluido la factura en formato facturae"
								}
							}
						}
					}
				}
			},
			"SendDocumentResponse": {
				"description": "Resultado del envío de un documento",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "SendDocumentResponse",
							"required": [
								"from",
								"to"
							],
							"additionalProperties": false,
							"properties": {
								"from": {
									"type": "string",
									"description": "Remitente usado para el envío"
								},
								"to": {
									"type": "array",
									"description": "Destinatario al que se ha enviado el documento",
									"items": {
										"type": "string"
									}
								},
								"cc": {
									"type": "array",
									"description": "Destinatario al que se ha enviado en copia visible el documento",
									"items": {
										"type": "string"
									}
								},
								"bcc": {
									"type": "array",
									"description": "Destinatarios al que se ha enviado en copia oculta el documento",
									"items": {
										"type": "string"
									}
								}
							}
						}
					}
				}
			},
			"GetDocumentPDFResponse": {
				"description": "Resultado de la petición de generación de un PDF temporal de un documento",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "GetDocumentPDFResponse",
							"required": [
								"url",
								"filename",
								"availableUntil"
							],
							"additionalProperties": false,
							"properties": {
								"url": {
									"type": "string",
									"description": "URL desde la que descargar o visualizar el archivo solicitado. Puede apuntar a un documento PDF (modos de descarga o visualización) o a un documento HTML (modo impresión)."
								},
								"filename": {
									"type": "string",
									"description": "Nombre del archivo PDF generado. Este nombre es el que enviará el servidor a través de la cabecera Content-Disposition si se intenta descargar el documento PDF."
								},
								"availableUntil": {
									"type": "string",
									"format": "date-time",
									"description": "Fecha y hora hasta la que estará disponible el documento generado."
								},
								"urlPdf": {
									"type": "string",
									"description": "URL desde la que descargar el archivo con la factura en formato PDF cuando se ha solictiado el modo impresión, para otros modos no se recibe este elemento."
								}
							}
						}
					}
				}
			},
			"IdempotencyKeyReusedError": {
				"description": "Respuesta de error cuando la cabecera `Idempotency-Key` ya se usó en las últimas 24 horas con otra petición: otro método, otra ruta u otro cuerpo. El código `idempotency_key_reused` va en `errors[0].code`.",
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "IdempotencyKeyReusedErrorResponse",
							"required": [
								"statusCode",
								"message"
							],
							"additionalProperties": false,
							"properties": {
								"statusCode": {
									"type": "integer",
									"enum": [
										422
									]
								},
								"message": {
									"type": "string"
								},
								"errors": {
									"type": "array",
									"items": {
										"type": "object",
										"additionalProperties": true
									}
								}
							}
						}
					}
				}
			}
		},
		"parameters": {
			"Accept-Version": {
				"name": "accept-version",
				"description": "Número de versión de la API. Valor por defecto: `1.0.10`",
				"in": "header",
				"schema": {
					"type": "string"
				}
			},
			"Idempotency-Key": {
				"name": "Idempotency-Key",
				"description": "Clave de idempotencia, opcional. Permite reintentar esta operación sin riesgo de ejecutarla dos veces, por ejemplo tras un timeout o una respuesta perdida.\n\nDe 16 a 255 caracteres ASCII visibles, sin espacios. Recomendamos un UUID v4; también vale un identificador con prefijo derivado del registro de origen (`migracion-factura-12345`). No debe contener datos sensibles.\n\nLa clave es única por empresa durante 24 horas y queda ligada a esta petición concreta (método, ruta, query y cuerpo):\n\n* Misma clave y misma petición, con la original ya terminada: se devuelve la respuesta original sin ejecutar nada, con las cabeceras `Idempotent-Replayed: true`, `Idempotent-Original-Date` e `Idempotent-Original-Request-Id`.\n* Misma clave con la original todavía en curso: `409` con código `idempotency_key_in_use` y cabecera `Retry-After`.\n* Misma clave con otra petición (otro método, otra ruta u otro cuerpo): `422` con código `idempotency_key_reused`.\n* Clave con formato no válido: `400` con código `invalid_idempotency_key`.\n\nSi la petición original termina en error la clave se libera y el reintento se ejecuta de nuevo.\n\nCuando la clave se aplica, la respuesta la devuelve en la cabecera `Idempotency-Key`. Las operaciones que no declaran este parámetro ignoran la cabecera y su respuesta no la devuelve.",
				"in": "header",
				"schema": {
					"type": "string"
				}
			},
			"CompanyId": {
				"name": "companyId",
				"description": "ID de la empresa",
				"required": true,
				"in": "path",
				"schema": {
					"type": "string"
				}
			},
			"Limit": {
				"name": "limit",
				"in": "query",
				"description": "Número máximo de resultados, valores permitidos entre 1 y 500",
				"schema": {
					"type": "integer",
					"minimum": 1,
					"maximum": 500
				}
			},
			"Offset": {
				"name": "offset",
				"in": "query",
				"description": "Posición de inicio de los resultados. Utilizado para paginar",
				"schema": {
					"type": "integer",
					"minimum": 0
				}
			},
			"MinCreationDate": {
				"name": "minCreationDate",
				"in": "query",
				"required": false,
				"description": "Fecha y hora mínima de creación del documento, incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta desde el inicio de ese día en la zona horaria de la empresa.",
				"allowReserved": true,
				"schema": {
					"type": "string",
					"anyOf": [
						{
							"type": "string",
							"format": "date"
						},
						{
							"type": "string",
							"format": "date-time"
						}
					]
				}
			},
			"MaxCreationDate": {
				"name": "maxCreationDate",
				"in": "query",
				"required": false,
				"description": "Fecha y hora máxima de creación del documento, incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta hasta el final de ese día en la zona horaria de la empresa.",
				"allowReserved": true,
				"schema": {
					"type": "string",
					"anyOf": [
						{
							"type": "string",
							"format": "date"
						},
						{
							"type": "string",
							"format": "date-time"
						}
					]
				}
			},
			"MinModificationDate": {
				"name": "minModificationDate",
				"in": "query",
				"required": false,
				"description": "Fecha y hora mínima de modificación del documento, incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta desde el inicio de ese día en la zona horaria de la empresa.",
				"allowReserved": true,
				"schema": {
					"type": "string",
					"anyOf": [
						{
							"type": "string",
							"format": "date"
						},
						{
							"type": "string",
							"format": "date-time"
						}
					]
				}
			},
			"MaxModificationDate": {
				"name": "maxModificationDate",
				"in": "query",
				"required": false,
				"description": "Fecha y hora máxima de modificación del documento, incluida, en formato ISO 8601 (`YYYY-MM-DDTHH:mm:ss.sssZ`); el `+` de un desfase horario se codifica como `%2B`. Admite también solo la fecha (`YYYY-MM-DD`): cuenta hasta el final de ese día en la zona horaria de la empresa.",
				"allowReserved": true,
				"schema": {
					"type": "string",
					"anyOf": [
						{
							"type": "string",
							"format": "date"
						},
						{
							"type": "string",
							"format": "date-time"
						}
					]
				}
			}
		},
		"requestBodies": {
			"SendInvoiceRequest": {
				"description": "Definición del envío del documento.\n\nPueden omitirse todos los elementos y se enviará el documento a los destinatarios incluidos en el mismo en los elementos \"emails\", \"emailsCc\" o \"emailsBcc\"; y con el título y contenido del mensaje de la plantilla del documento.\n\nSi se indica cualquiera de los siguientes elementos en la llamada (\"to\", \"cc\" o \"bcc\") se ignorarán los emails indicados en los elementos \"emails\", \"emailsCc\" o \"emailsBcc\" del documento.\n\nEn cualquier caso debe existir al menos un destinatario al que enviar el documento (con independencia de que haya o no destinatarios en copia visible u oculta).\n\nEn caso de que no se pueda determinar ningún destinatario la llamada fallará con un error 409.",
				"required": true,
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "SendInvoiceRequest",
							"properties": {
								"from": {
									"type": "string",
									"description": "Email remitente del envío (\"From\"), debe ser uno de los remitentes dados de alta en la configuración de la emprea. Si no se indica se utilizará el primer remitente disponible en la configuración de la empresa.\n\nSi no se indica y no existiera ningún remitente configurado en la empresa la llamada fallará con un error 409."
								},
								"to": {
									"type": "array",
									"description": "Destinatarios del envío del documento",
									"items": {
										"type": "string"
									}
								},
								"cc": {
									"type": "array",
									"description": "Destinatarios en copia visible del envío del documento",
									"items": {
										"type": "string"
									}
								},
								"bcc": {
									"type": "array",
									"description": "Destinatarios en copia oculta del envío del documento",
									"items": {
										"type": "string"
									}
								},
								"subject": {
									"type": "string",
									"description": "Título del mensaje enviado. Si no se indica se utiliza el de la plantilla del documento"
								},
								"html": {
									"type": "string",
									"description": "Contenido en formato HTML del mensaje enviado. Si no se indica se utiliza el de la plantilla del documento"
								},
								"sendFacturae": {
									"type": "boolean",
									"description": "Incluir en el envío también la factura en formato facturae."
								},
								"continueWithoutFacturae": {
									"type": "boolean",
									"description": "Indica el comportamiento cuando se solicita el envío de facturae y esta no puede generarse por algún motivo.\n\nSi se indica \"true\" el envío se realizará normalmente aunque no se pueda genear la factura en formato factura, si se indica \"false\" (el valor por defecto) la llamada fallará con un error 409 si se ha solicitado el envío de facturae y esta no puede generarse.\n\nEste elemento es ignorado si no se ha solicitado el envío de facturae."
								}
							}
						},
						"examples": {
							"to": {
								"summary": "Un destinatario",
								"description": "Envío a un solo destinatario",
								"value": {
									"to": [
										"my_client@example.com"
									]
								}
							},
							"to2": {
								"summary": "Varios destinatarios",
								"description": "Envío a un solo destinatario",
								"value": {
									"to": [
										"my_client_1@example.com",
										"my_client_2@example.com",
										"my_client_3@example.com"
									]
								}
							},
							"cc": {
								"summary": "Destinatario y copia",
								"description": "Envío a un destinatrio y en copia a otro email",
								"value": {
									"to": [
										"my_client@example.com"
									],
									"cc": [
										"other_user@example.com"
									]
								}
							},
							"bcc": {
								"summary": "Destinatario, copia y copia oculta",
								"description": "Envío a un destinatrio, en copia a otro email y en copia oculta a un tercero",
								"value": {
									"to": [
										"my_client@example.com"
									],
									"cc": [
										"other_user@example.com"
									],
									"bcc": [
										"my_company@example.com"
									]
								}
							},
							"remitente": {
								"summary": "Remitente personalizado",
								"description": "Envío desde un remitente personalizado.\n\n.Debe estar autorizado en las preferencias de la empreesa.",
								"value": {
									"from": "my_company@example.com",
									"to": [
										"my_client@example.com"
									]
								}
							},
							"facturae": {
								"summary": "Envío de facturae",
								"description": "Envío incluyendo la factura en formato facturae y con error si falla la creación de la facturae.",
								"value": {
									"to": [
										"my_client@example.com"
									],
									"sendFacturae": true
								}
							},
							"facturaeOptional": {
								"summary": "Envío de facturae opcional",
								"description": "Envío incluyendo la factura en formato facturae sin error en caso de que falle la creación de la facturae.",
								"value": {
									"to": [
										"my_client@example.com"
									],
									"sendFacturae": true,
									"continueWithoutFacturae": true
								}
							},
							"customMessage": {
								"summary": "Mensaje personalizado",
								"description": "Envío con el título y contenido del mensaje personalizado (en lugar de usar los valores de la plantilla del documento).",
								"value": {
									"to": [
										"my_client@example.com"
									],
									"subject": "Factura definitiva",
									"html": "Estimado cliente.<p>Adjunta encontrará su factura número <b>####</b></p>"
								}
							}
						}
					}
				}
			},
			"SendDocumentRequest": {
				"description": "Definición del envío del documento.\n\nPueden omitirse todos los elementos y se enviará el documento a los destinatarios incluidos en el mismo en los elementos \"emails\", \"emailsCc\" o \"emailsBcc\"; y con el título y contenido del mensaje de la plantilla del documento.\n\nSi se indica cualquiera de los siguientes elementos en la llamada (\"to\", \"cc\" o \"bcc\") se ignorarán los emails indicados en los elementos \"emails\", \"emailsCc\" o \"emailsBcc\" del documento.\n\nEn cualquier caso debe existir al menos un destinatario al que enviar el documento (con independencia de que haya o no destinatarios en copia visible u oculta).\n\nEn caso de que no se pueda determinar ningún destinatario la llamada fallará con un error 409.",
				"required": true,
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "SendDocumentRequest",
							"properties": {
								"from": {
									"type": "string",
									"description": "Email remitente del envío (\"From\"), debe ser uno de los remitentes dados de alta en la configuración de la emprea. Si no se indica se utilizará el primer remitente disponible en la configuración de la empresa.\n\nSi no se indica y no existiera ningún remitente configurado en la empresa la llamada fallará con un error 409."
								},
								"to": {
									"type": "array",
									"description": "Destinatarios del envío del documento",
									"items": {
										"type": "string"
									}
								},
								"cc": {
									"type": "array",
									"description": "Destinatarios en copia visible del envío del documento",
									"items": {
										"type": "string"
									}
								},
								"bcc": {
									"type": "array",
									"description": "Destinatarios en copia oculta del envío del documento",
									"items": {
										"type": "string"
									}
								},
								"subject": {
									"type": "string",
									"description": "Título del mensaje enviado. Si no se indica se utiliza el de la plantilla del documento"
								},
								"html": {
									"type": "string",
									"description": "Contenido en formato HTML del mensaje enviado. Si no se indica se utiliza el de la plantilla del documento"
								}
							}
						},
						"examples": {
							"to": {
								"summary": "Un destinatario",
								"description": "Envío a un solo destinatario",
								"value": {
									"to": [
										"my_client@example.com"
									]
								}
							},
							"to2": {
								"summary": "Varios destinatarios",
								"description": "Envío a un solo destinatario",
								"value": {
									"to": [
										"my_client_1@example.com",
										"my_client_2@example.com",
										"my_client_3@example.com"
									]
								}
							},
							"cc": {
								"summary": "Destinatario y copia",
								"description": "Envío a un destinatrio y en copia a otro email",
								"value": {
									"to": [
										"my_client@example.com"
									],
									"cc": [
										"other_user@example.com"
									]
								}
							},
							"bcc": {
								"summary": "Destinatario, copia y copia oculta",
								"description": "Envío a un destinatrio, en copia a otro email y en copia oculta a un tercero",
								"value": {
									"to": [
										"my_client@example.com"
									],
									"cc": [
										"other_user@example.com"
									],
									"bcc": [
										"my_company@example.com"
									]
								}
							},
							"remitente": {
								"summary": "Remitente personalizado",
								"description": "Envío desde un remitente personalizado.\n\n.Debe estar autorizado en las preferencias de la empreesa.",
								"value": {
									"from": "my_company@example.com",
									"to": [
										"my_client@example.com"
									]
								}
							},
							"customMessage": {
								"summary": "Mensaje personalizado",
								"description": "Envío con el título y contenido del mensaje personalizado (en lugar de usar los valores de la plantilla del documento).",
								"value": {
									"to": [
										"my_client@example.com"
									],
									"subject": "Documento solicitado",
									"html": "Estimado cliente.<p>Adjunta encontrará el documento solicitado</p>"
								}
							}
						}
					}
				}
			},
			"CreateDocumentPDFRequest": {
				"description": "Solicitud de creación de una versión en PDF de un documento.\n\nSe obtendrá una URL temporal que será válida durante el tiempo indicado en la respuesta.\n\nSe puede solicitar para distintos modos de uso:\n\n* **attachment**: Se recibe una URL de un archivo que se descargará como adjunto\n* **inline**: Se recibe una URL de un archivo que se descargará para visualiar en línea\n* **print**: Se recibe una URL de un archivo HTML que se puede visualizar en línea y carga el documento en formato PDF y lo envía a imprimir. Adicionalmente se recibe también la url del documento en formado PDF para visualización en línea",
				"required": true,
				"content": {
					"application/json": {
						"schema": {
							"type": "object",
							"title": "CreateDocumentPDFRequest",
							"properties": {
								"mode": {
									"type": "string",
									"enum": [
										"attachment",
										"inline",
										"print"
									],
									"description": "Modo de respuesta solicitada: adjunto (attachment), visualización en línea (inline) o impresión (print)"
								}
							}
						},
						"examples": {
							"attachment": {
								"summary": "Modo descarga (attachment)",
								"description": "Se solicita recibir la URL de un documento que será servido como adjunto.\n\nCon Content-Disposition: attachment",
								"value": {
									"mode": "attachment"
								}
							},
							"inline": {
								"summary": "Modo visualización (inline)",
								"description": "Se solicita recibir la URL de un documento que será servido para su visualización.\n\nCon Content-Disposition: inline",
								"value": {
									"mode": "inline"
								}
							},
							"print": {
								"summary": "Modo impresión (print)",
								"description": "Se solicita recibir la URL de un documento html que cargará el doucmento en PDF y lo enviará a imprimir. Se recibe también URL del documento en formato PDF para visualización en línea",
								"value": {
									"mode": "print"
								}
							}
						}
					}
				}
			}
		},
		"securitySchemes": {
			"apiKey": {
				"type": "apiKey",
				"description": "Autorización mediante apiKey para la api pública de FacturaDirecta.\n\nPuedes obtener una apiKey para una empresa concreta desde la página de Ajustes > API e integraciones de tu empresa en FacturaDirecta.\n\nCuando crees tu apiKey le puedes asignar los mismos _scopes_ de acceso que puedes seleccionar en la autorización mediante _oauth2_ (excepto el de offline_access que por definición ya se tiene con este modo de autorización)\n      ",
				"name": "facturadirecta-api-key",
				"in": "header"
			},
			"oAuth": {
				"type": "oauth2",
				"description": "Servicio de autorización OAuth2 para la API pública de FacturaDirecta.\n\nIndicar únicamente el valor `facturadirecta-api` para `client_id`. No es necesario indicar ningún secreto en el campo `client_secret`.\n\n**PKCE es obligatorio.** La petición al endpoint de autorización (`/auth`) debe incluir los parámetros `code_challenge` y `code_challenge_method=S256` (ver [RFC 7636](https://datatracker.ietf.org/doc/html/rfc7636)). En el intercambio del `code` por el `access_token` (`POST /token`) debe enviarse el `code_verifier` original. Las peticiones sin PKCE serán rechazadas con un error `invalid_request`.\n",
				"flows": {
					"authorizationCode": {
						"authorizationUrl": "https://auth.facturadirecta.com/auth/realms/facturadirecta/protocol/openid-connect/auth",
						"tokenUrl": "https://auth.facturadirecta.com/auth/realms/facturadirecta/protocol/openid-connect/token",
						"refreshUrl": "https://auth.facturadirecta.com/auth/realms/facturadirecta/protocol/openid-connect/token",
						"scopes": {
							"offline_access": "Acceso permanente",
							"contacts:read": "Lectura de contactos",
							"contacts:write": "Modificación de contactos",
							"products:read": "Lectura de productos",
							"products:write": "Modificación de productos",
							"invoices:read": "Lectura de facturas",
							"invoices:write": "Modificación de facturas",
							"estimates:read": "Lectura de presupuestos",
							"estimates:write": "Modificación de presupuestos",
							"deliveryNotes:read": "Lectura de albaranes",
							"deliveryNotes:write": "Modificación de albaranes",
							"clientOrders:read": "Lectura de pedidos",
							"clientOrders:write": "Modificación de pedidos",
							"purchaseOrders:read": "Lectura de órdenes de compra",
							"purchaseOrders:write": "Modificación de órdenes de compra",
							"bills:read": "Lectura de facturas de compra y tickets",
							"bills:write": "Modificación de facturas de compra y tickets",
							"payrolls:read": "Lectura de nóminas",
							"payrolls:write": "Modificación de nóminas",
							"recurring:read": "Lectura de documentos recurrentes",
							"recurring:write": "Modificación de documentos recurrentes",
							"banks:read": "Lectura de bancos y cuentas de tesorería, sus saldos y el estado de su enlace",
							"banks:readIban": "Incluir el IBAN completo en los bancos propios en las consultas de bancos o de métodos de pago",
							"paymentMethods:read": "Lectura de métodos de pago",
							"paymentMethods:readIban": "Incluir el IBAN completo de los bancos de los contactos en sus métodos de pago",
							"paymentMethods:write": "Esctritura de métodos de pago",
							"accounting:read": "Lectura de datos de contabilidad (diario)",
							"settings:read": "Lectura de ajustes/datos de configuración",
							"webhooks:read": "Leer configuración y historial de webhooks",
							"webhooks:write": "Gestionar endpoints de webhooks",
							"customFields:read": "Lectura de campos personalizados",
							"customFields:write": "Gestión de campos personalizados",
							"apiKeys:read": "Lectura de API keys",
							"apiKeys:write": "Gestión de API keys (creación y eliminación)",
							"statements:read": "Lectura de extractos bancarios",
							"statements:write": "Conciliación de extractos bancarios",
							"files:write": "Subida de archivos para adjuntar a documentos",
							"inbox:read": "Lectura de la bandeja de entrada de documentos pendientes de procesar",
							"inbox:write": "Subida y gestión de documentos en la bandeja de entrada",
							"activity:read": "Lectura del registro de actividad de la empresa",
							"taxDeclarations:read": "Lectura de los modelos de impuestos generados (declaraciones), sus casillas, PDF y fichero de presentación"
						}
					}
				}
			}
		}
	},
	"x-tagGroups": [
		{
			"name": "Ventas",
			"tags": [
				"Facturas de venta",
				"Facturas de venta recurrentes",
				"Presupuestos",
				"Pedidos",
				"Albaranes"
			]
		},
		{
			"name": "Compras y gastos",
			"tags": [
				"Facturas de compra y tickets",
				"Órdenes de compra",
				"Bandeja de entrada",
				"Uploads"
			]
		},
		{
			"name": "Contactos y productos",
			"tags": [
				"Contactos",
				"Productos",
				"Campos personalizados"
			]
		},
		{
			"name": "Tesorería",
			"tags": [
				"Bancos",
				"Extractos bancarios",
				"Métodos de pago"
			]
		},
		{
			"name": "Contabilidad y nóminas",
			"tags": [
				"Contabilidad",
				"Informes",
				"Declaraciones de impuestos",
				"Nóminas"
			]
		},
		{
			"name": "Consultas y actividad",
			"tags": [
				"Búsqueda",
				"Consultas",
				"Actividad"
			]
		},
		{
			"name": "Cuenta y configuración",
			"tags": [
				"Usuario",
				"Ajustes",
				"API Keys"
			]
		},
		{
			"name": "Webhooks",
			"tags": [
				"Webhooks"
			]
		}
	]
}
