Merge pull request #158 from FacturAPI/update-operation-links

javorosas · web-flow · commit 358313d1b4c9 · 2025-01-23T13:08:11.000-07:00
diff --git a/website/docs/guides/customers.mdx b/website/docs/guides/customers.mdx
@@ -39,7 +39,7 @@ separado, ya que sí es diferente de como lo indica el SAT en su estándar técn
 El siguiente ejemplo muestra cómo registrar a un cliente nacional.
 
 Para conocer qué otros datos puedes incluir, consulta la
-[referencia del método Crear Cliente](/api/#operation/createCustomer).
+[referencia del método Crear Cliente](/api/#tag/customer/operation/createCustomer).
 
 <Tabs groupId="codeExamples">
 <TabItem value="js" label="Node.js" default>
@@ -159,7 +159,7 @@ de `"MEX"` para el campo `country`.
 :::
 
 Para conocer qué otros datos puedes incluir, consulta la
-[referencia completa del método Crear Cliente](/api/#operation/createCustomer).
+[referencia completa del método Crear Cliente](/api/#tag/customer/operation/createCustomer).
 
 <Tabs groupId="codeExamples">
 <TabItem value="js" label="Node.js" default>
diff --git a/website/docs/guides/invoices/complementos.md b/website/docs/guides/invoices/complementos.md
@@ -4,7 +4,7 @@ sidebar_position: 7
 
 # Complementos
 
-Actualmente, FacturAPI soporta la emisión de todos los tipos de CFDI que existen así como todos los complementos del SAT. Puedes ver cómo cear los diferentes tipos de comprobantes en la referencia de [Crear Factura](/api#operation/createInvoice) y [Crear Retención](/api#operation/createRetention)
+Actualmente, FacturAPI soporta la emisión de todos los tipos de CFDI que existen así como todos los complementos del SAT. Puedes ver cómo cear los diferentes tipos de comprobantes en la referencia de [Crear Factura](/api#tag/invoice/operation/createInvoice) y [Crear Retención](/api#tag/retention/operation/createRetention)
 
 :::note
 
diff --git a/website/docs/guides/invoices/egreso.mdx b/website/docs/guides/invoices/egreso.mdx
@@ -29,7 +29,7 @@ A continuación se listan algunos casos de uso comunes.
 
 Para conocer a fondo todas las opciones disponibles al crear una factura, descripciiones
 detalladas de cada campo y los catálogos más utilizados consulta la
-[referencia del método Crear Factura](/api/#operation/createInvoice).
+[referencia del método Crear Factura](/api/#tag/invoice/operation/createInvoice).
 
 ### Descuento por una venta ya facturada
 En este ejemplo, se recibió un pago de $3,600.00 pesos por un producto con el 10% descuento que tiene un valor de $4,000.00 pesos, los $400.00 pesos descontados se amparan emitiendo un CFDI de egreso.
diff --git a/website/docs/guides/invoices/ingreso.mdx b/website/docs/guides/invoices/ingreso.mdx
@@ -28,7 +28,7 @@ A continuación se enlistan algunos casos de uso comunes.
 
 Para conocer a fondo todas las opciones disponibles al crear una factura, descripciiones
 detalladas de cada campo y los catálogos más utilizados consulta la
-[referencia del método Crear Factura](/api/#operation/createInvoice).
+[referencia del método Crear Factura](/api/#tag/invoice/operation/createInvoice).
 
 ### Factura con pago de contado (default)
 
diff --git a/website/docs/guides/invoices/nomina.mdx b/website/docs/guides/invoices/nomina.mdx
@@ -20,7 +20,7 @@ El CFDI de nómina puede identificarse como tipo de comprobante "N"
 
 Para conocer a fondo todas las opciones disponibles al crear una factura, descripciiones
 detalladas de cada campo y los catálogos más utilizados consulta la
-[referencia del método Crear Factura](/api/#operation/createInvoice).
+[referencia del método Crear Factura](/api/#tag/invoice/operation/createInvoice).
 
 ### Comprobante emitido para amparar el servicio prestado por un empleado
 
diff --git a/website/docs/guides/invoices/pago.mdx b/website/docs/guides/invoices/pago.mdx
@@ -23,7 +23,7 @@ A continuación se enlistan algunos casos de uso comunes.
 
 Para conocer a fondo todas las opciones disponibles al crear un Comprobante de Pago, descripciiones
 detalladas de cada campo y los catálogos más utilizados consulta la
-[referencia del método Crear Factura](/api/#operation/createInvoice), y posteriormente haz clic sobre
+[referencia del método Crear Factura](/api/#tag/invoice/operation/createInvoice), y posteriormente haz clic sobre
 el tipo de factura **Pago**.
 
 ### Pago total de una factura pendiente
diff --git a/website/docs/guides/invoices/relacionados.mdx b/website/docs/guides/invoices/relacionados.mdx
@@ -12,7 +12,7 @@ Además de los distintos tipos de comprobantes, existe un concepto conocido como
 ## Algunos Ejemplos de relación entre facturas
 Para conocer a fondo todas las opciones disponibles al crear una factura, descripciiones
 detalladas de cada campo y los catálogos más utilizados consulta la
-[referencia del método Crear Factura](/api/#operation/createInvoice).
+[referencia del método Crear Factura](/api/#tag/invoice/operation/createInvoice).
 
 ### Cuando se realiza un descuento 
 En el momento de realizar una venta con descuento, se puede emitir un CFDI de egreso para que dicha bonificación sea deducible
diff --git a/website/docs/guides/invoices/retencion.mdx b/website/docs/guides/invoices/retencion.mdx
@@ -56,4 +56,4 @@ A continuación encontrarás el ejemplo de una petición sencilla para emitir un
 
 Para conocer a fondo todas las opciones disponibles al crear un CFDI de retenciones, descripciones
 detalladas de cada campo y los catálogos más utilizados consulta la
-[referencia del método Crear Retención](/api/#operation/createRetention).
+[referencia del método Crear Retención](/api/#tag/retention/operation/createRetention).
diff --git a/website/docs/guides/invoices/traslado.mdx b/website/docs/guides/invoices/traslado.mdx
@@ -28,7 +28,7 @@ Cuando se utiliza un comprobante de tipo Traslado, este puede emitirse en ceros
 
 Para conocer a fondo todas las opciones disponibles al crear una factura, descripciiones
 detalladas de cada campo y los catálogos más utilizados consulta la
-[referencia del método Crear Factura](/api/#operation/createInvoice).
+[referencia del método Crear Factura](/api/#tag/invoice/operation/createInvoice).
 
 ### Transporte de bienes entre dos puntos
 
diff --git a/website/docs/guides/organizations.mdx b/website/docs/guides/organizations.mdx
@@ -10,7 +10,7 @@ import TabItem from '@theme/TabItem';
 ## Registra más organizaciones emisoras
 
 Puedes emitir facturas desde distintos RFC registrando nuevas organizaciones emisoras,
-ya sea desde tu dashboard o usando la API, con el método [Crear Organización](/api#operation/createOrganization),
+ya sea desde tu dashboard o usando la API, con el método [Crear Organización](/api#tag/organization/operation/createOrganization),
 así como los demás métodos para configurar datos fiscales, logotipo y colores, certificados, etc.
 
 :::info
diff --git a/website/docs/guides/products.mdx b/website/docs/guides/products.mdx
@@ -28,7 +28,7 @@ Los siguiente ejemplos muestran cómo registrar la información de tu producto o
 servicio para usarse en futuras facturas.
 
 Para conocer todos los argumentos que puedes incluir en la llamada, consulta la
-[referencia del método Crear Producto](/api/#operation/createProduct).
+[referencia del método Crear Producto](/api/#tag/product/operation/createProduct).
 
 ### Producto con IVA 16% con impuestos incluídos (default)
 
diff --git a/website/docs/guides/receipts.mdx b/website/docs/guides/receipts.mdx
@@ -22,7 +22,7 @@ recibos que no fueron facturados.
 ## Crear un recibo
 
 Para ver las descripciones de todos los parámetros, consulta la referencia completa del
-método [Crear Recibo](/api/#operation/createReceipt).
+método [Crear Recibo](/api/#tag/receipt/operation/createReceipt).
 
 <Tabs groupId="codeExamples">
 <TabItem value="js" label="Node.js" default>
@@ -121,7 +121,7 @@ Para más información consulta el artículo de [Autofactura](/docs/guides/self-
 
 ## Facturar un recibo
 
-Por medio del método [Facturar Recibo](/api/#operation/invoiceReceipt) puedes convertir
+Por medio del método [Facturar Recibo](/api/#tag/receipt/operation/invoiceReceipt) puedes convertir
 un e-receipt en una factura. Para ello, debes enviar los datos del cliente y otros datos que
 no se solicitan al crear el recibo.
 
diff --git a/website/docs/guides/self-invoice.mdx b/website/docs/guides/self-invoice.mdx
@@ -40,7 +40,7 @@ Si cuentas con una suscripción activa, puedes seleccionar un dominio para
 una organización, desde la
 [Configuración de Recibos](https://dashboard.facturapi.io/settings/receipts)
 en el dashboard, o llamando al método
-[Elegir dominio para autofactura](/api/#operation/editOrganizationDomain)
+[Elegir dominio para autofactura](/api/#tag/organization/operation/editOrganizationDomain)
 desde la API.
 
 Una vez elegido un dominio, nosotros asignaremos automáticamente el campo
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/customers.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/customers.mdx
@@ -37,7 +37,7 @@ The following example shows how to register a national customer, that is, a
 customer (person or company) with a Mexican tax ID (RFC).
 
 To learn about other data you can include, refer to the
-[Create Customer API reference](/api/#operation/createCustomer).
+[Create Customer API reference](/api/#tag/customer/operation/createCustomer).
 
 <Tabs groupId="codeExamples">
 <TabItem value="js" label="Node.js" default>
@@ -157,7 +157,7 @@ other than `"MEX"` for the `country` field.
 :::
 
 To learn about other data you can include, refer to the
-[Create Customer API reference](/api/#operation/createCustomer).
+[Create Customer API reference](/api/#tag/customer/operation/createCustomer).
 
 <Tabs groupId="codeExamples">
 <TabItem value="js" label="Node.js" default>
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/complementos.md b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/complementos.md
@@ -6,8 +6,8 @@ sidebar_position: 7
 
 Currently, FacturAPI supports the issuance of all types of CFDI as well as all
 SAT add-ons or complements. You can see how to create different types of CFDI
-documents in the [Create Invoice](/api#operation/createInvoice) and
-[Create Retention](/api#operation/createRetention) references.
+documents in the [Create Invoice](/api#tag/invoice/operation/createInvoice) and
+[Create Retention](/api#tag/retention/operation/createRetention) references.
 
 :::note
 You can insert any complement by adding the corresponding XML in the
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/egreso.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/egreso.mdx
@@ -32,7 +32,7 @@ Below are some common use cases.
 
 To fully understand all the available options when creating an invoice,
 detailed descriptions of each field, and the most commonly used catalogs,
-please refer to the [Create Invoice method reference](/api/#operation/createInvoice).
+please refer to the [Create Invoice method reference](/api/#tag/invoice/operation/createInvoice).
 
 #### Discount for an already invoiced sale
 
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/ingreso.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/ingreso.mdx
@@ -28,7 +28,7 @@ Below are some common use cases.
 
 To fully understand all the options available when creating an invoice, detailed
 descriptions of each field and the most commonly used catalogs, consult the
-[Create Invoice method reference](/api/#operation/createInvoice).
+[Create Invoice method reference](/api/#tag/invoice/operation/createInvoice).
 
 ### Paid invoices (default)
 
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/nomina.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/nomina.mdx
@@ -19,7 +19,7 @@ The payroll CFDI can be identified as a document with type "N".
 
 ## Examples
 
-To fully understand all the available options when creating an invoice, detailed descriptions of each field, and the most commonly used catalogs, please refer to the [Create Invoice API Reference](/api/#operation/createInvoice), and then click on the **Nómina** invoice type.
+To fully understand all the available options when creating an invoice, detailed descriptions of each field, and the most commonly used catalogs, please refer to the [Create Invoice API Reference](/api/#tag/invoice/operation/createInvoice), and then click on the **Nómina** invoice type.
 
 ### Invoice issued to cover the service provided by an employee
 
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/pago.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/pago.mdx
@@ -16,7 +16,7 @@ To issue a **Payment Invoice**, there must be an Income Invoice that is created
 
 Below are some common use cases.
 
-To fully understand all the available options when creating a Payment Invoice, detailed descriptions of each field, and the most commonly used catalogs, please refer to the [Create Invoice method reference](/api/#operation/createInvoice), and then click on the **Payment** invoice type.
+To fully understand all the available options when creating a Payment Invoice, detailed descriptions of each field, and the most commonly used catalogs, please refer to the [Create Invoice method reference](/api/#tag/invoice/operation/createInvoice), and then click on the **Payment** invoice type.
 
 ### Full payment of a pending invoice
 
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/relacionados.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/relacionados.mdx
@@ -12,7 +12,7 @@ In addition to the different types of invoices, there is a concept known as "Rel
 
 ## Some Examples of Invoice Relationships
 
-To fully understand all the available options when creating an invoice, detailed descriptions of each field, and the most commonly used catalogs, please refer to the [Create Invoice API reference](/api/#operation/createInvoice).
+To fully understand all the available options when creating an invoice, detailed descriptions of each field, and the most commonly used catalogs, please refer to the [Create Invoice API reference](/api/#tag/invoice/operation/createInvoice).
 
 ### When giving a discount
 
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/retencion.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/retencion.mdx
@@ -60,4 +60,4 @@ Below you will find an example of a simple request to issue a retention invoice:
 
 To fully understand all the available options when creating a retention CFDI,
 detailed descriptions of each field and the most commonly used catalogs,
-please refer to the [Create Retention method reference](/api/#operation/createRetention).
+please refer to the [Create Retention method reference](/api/#tag/retention/operation/createRetention).
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/traslado.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/traslado.mdx
@@ -31,7 +31,7 @@ value of the goods is not important, but rather their legal possession.
 
 To fully understand all the available options when creating a invoice, detailed
 descriptions of each field, and the most commonly used catalogs, please refer
-to the [Create Invoice method reference](/api/#operation/createInvoice).
+to the [Create Invoice method reference](/api/#tag/invoice/operation/createInvoice).
 
 ### Transportation of goods between two points
 
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/products.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/products.mdx
@@ -26,7 +26,7 @@ The following examples show how to register the information of your product or
 service to be used in future invoices.
 
 To learn about all the arguments you can include in the call, check the
-[Create Product method reference](/api/#operation/createProduct).
+[Create Product method reference](/api/#tag/product/operation/createProduct).
 
 ### Product with 16% VAT and taxes included (default)
 
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/receipts.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/receipts.mdx
@@ -23,7 +23,7 @@ receipts that were not invoiced (known as global invoice).
 ## Create a receipt
 
 To see the descriptions of all the parameters, consult the complete reference of the
-method [Create Receipt](/api/#operation/createReceipt).
+method [Create Receipt](/api/#tag/receipt/operation/createReceipt).
 
 
 <Tabs groupId="codeExamples">
@@ -123,7 +123,7 @@ For more information, see the article on [Self-Invoice](/docs/guides/self-invoic
 
 ## Convert an e-receipt into an invoice
 
-Por medio del método [Facturar Recibo](/api/#operation/invoiceReceipt) puedes convertir
+Por medio del método [Facturar Recibo](/api/#tag/receipt/operation/invoiceReceipt) puedes convertir
 un e-receipt en una factura. Para ello, debes enviar los datos del cliente y otros datos que
 no se solicitan al crear el recibo.
 
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guides/self-invoice.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/guides/self-invoice.mdx
@@ -41,7 +41,7 @@ your receipts will be `demo`.
 If you have an active subscription, you can select a domain for an organization
 from the [Receipt Settings](https://dashboard.facturapi.io/settings/receipts)
 section in the dashboard or by calling the
-[Choose self-invoicing domain](/api/#operation/editOrganizationDomain) method
+[Choose self-invoicing domain](/api/#tag/organization/operation/editOrganizationDomain) method
 from the API.
 
 Once a domain is chosen, we will automatically assign the `self_invoice_url`
diff --git a/website/openapi_v1.yaml b/website/openapi_v1.yaml
@@ -1525,7 +1525,7 @@ paths:
         - Que la llamada sea satisfactoria y regrese un objeto `invoice` con la propiedad `status: "canceled"`.
         - Que la llamada sea satisfactoria, pero que la cancelación requiera de confirmación de parte de tu cliente, en cuyo caso se obtendrá como respuesta el objeto `invoice` con las propiedades `status: "valid"` y `cancellation_status: "pending"`.
 
-        En el tercer escenario, el valor de `cancellation_status` será actualizado automáticamente por Facturapi cuando tu cliente acepte, rechace o deje expirar la solicitud, de tal manera que al consultar una factura (usando [Obtener Factura](#operation/getInvoice)), la propiedad `cancellation_status` reflejará el estado más reciente de la soliitud.
+        En el tercer escenario, el valor de `cancellation_status` será actualizado automáticamente por Facturapi cuando tu cliente acepte, rechace o deje expirar la solicitud, de tal manera que al consultar una factura (usando [Obtener Factura](#tag/invoice/operation/getInvoice)), la propiedad `cancellation_status` reflejará el estado más reciente de la soliitud.
 
         Consulta los valores posibles de `cancellation_status` más abajo.
 
@@ -2960,8 +2960,8 @@ paths:
 
         Después de crear la organización y antes de poder emitir facturas con
         la organización, deberás de terminar de configurarla llamando a los
-        métodos de [Actualizar datos fiscales](#operation/editOrganizationLegal) y
-        [Subir certificados (CSD)](#operation/uploadOrganizationCertificate)
+        métodos de [Actualizar datos fiscales](#tag/organization/operation/editOrganizationLegal) y
+        [Subir certificados (CSD)](#tag/organization/operation/uploadOrganizationCertificate)
 
         Recuerda que los folios de tu suscripción podrán ser consumidos por
         cualquiera de las organizaaciones registradas bajo tu cuenta.
@@ -5739,7 +5739,7 @@ components:
             - rejected
             - expired
           description: |
-            Estado actual de la solicitud de cancelación, en caso de haberla realizado. Puedes leer más a detalle en la sección de [Cancelar Factura](#operation/deleteInvoice)).
+            Estado actual de la solicitud de cancelación, en caso de haberla realizado. Puedes leer más a detalle en la sección de [Cancelar Factura](#tag/invoice/operation/deleteInvoice)).
           example: none
         verification_url:
           type: string
diff --git a/website/openapi_v2.en.yaml b/website/openapi_v2.en.yaml
diff --git a/website/openapi_v2.yaml b/website/openapi_v2.yaml
