Merge pull request #231 from FacturAPI/docs/v2-taxability-taxes-default

Author: javorosas

website/openapi_v2.en.yaml

@@ -10817,8 +10817,7 @@ components:
             - `false`: Indicates that the price attribute does not include taxes, so those taxes to be applied will be added to the final price.
         taxability:
           type: string
-          default: |
-            `"01"` if the `taxes` array is empty; `"02"` if the `taxes` array has at least one element.
+          default: "02"
           enum:
             - "01"
             - "02"
@@ -10841,14 +10840,23 @@ components:
             - `08`: Not Subject to tax IVA, and not required IEPS breakdown.
         taxes:
           type: array
-          default: IVA (VAT) transferred 16%
+          default:
+            - type: IVA
+              rate: 0.16
           example:
             [{
               "type": "IVA",
               "rate": 0.16
             }]
           description: |
-            List of taxes that must be applied to this product. If the parameter is omitted or null, it will be saved with an element representing the transferred IVA (VAT) of 16%, which is the most common tax. If an empty array is explicitly sent, it is understood that the product is exempt from taxes.
+            List of taxes that must be applied to this product.
+
+            Resolution when `taxes` is omitted or `null`:
+            - `taxability` omitted or `"02"`: IVA (VAT) transferred 16% is added.
+            - `taxability` in `"01"`, `"03"`, `"04"`, `"05"`, `"06"`, or `"08"`: `[]` is stored.
+            - `taxability = "07"`: the request is invalid; you must provide at least one transferred IEPS tax and include no IVA taxes.
+
+            If you send `taxes` explicitly, the provided array is used.
           items:
             $ref: "#/components/schemas/BaseTax"
         local_taxes:
@@ -10911,6 +10919,9 @@ components:
             - "03"
             - "04"
             - "05"
+            - "06"
+            - "07"
+            - "08"
           description: |
             Code that represents whether the good or service is subject to tax or not. This attribute corresponds to the "ObjetoImp" field in the CFDI.
 
@@ -10921,9 +10932,18 @@ components:
             - `05`: Subject to tax, VAT credit PODEBI.
         taxes:
           type: array
-          default: IVA (VAT) transferred 16%
+          default:
+            - type: IVA
+              rate: 0.16
           description: |
-            List of taxes that must be applied to this product. If the parameter is omitted or null, it will be saved with an element representing the transferred IVA (VAT) of 16%, which is the most common tax. If an empty array is explicitly sent, it is understood that the product is exempt from taxes.
+            List of taxes that must be applied to this product.
+
+            Resolution when `taxes` is omitted or `null`:
+            - `taxability` omitted or `"02"`: IVA (VAT) transferred 16% is added.
+            - `taxability` in `"01"`, `"03"`, `"04"`, `"05"`, `"06"`, or `"08"`: `[]` is stored.
+            - `taxability = "07"`: the request is invalid; you must provide at least one transferred IEPS tax and include no IVA taxes.
+
+            If you send `taxes` explicitly, the provided array is used.
           items:
             $ref: "#/components/schemas/BaseTax"
         local_taxes:

website/openapi_v2.yaml

@@ -11061,8 +11061,7 @@ components:
             - `false`: Indica que el atributo price no incluye impuestos, por lo que aquellos impuestos a aplicar se sumarán en el precio final.
         taxability:
           type: string
-          default: |
-            '01' si el array `taxes` está vacío; '02' si el array `taxes` tiene por lo menos un elemento.
+          default: "02"
           enum:
             - "01"
             - "02"
@@ -11085,13 +11084,23 @@ components:
             - `08`: No traslado de IVA sin desglose de IEPS.
         taxes:
           type: array
-          default: IVA trasladado 16%
+          default:
+            - type: IVA
+              rate: 0.16
           example:
             [{
               "type": "IVA",
               "rate": 0.16
             }]
-          description: Lista de impuestos que deberán aplicarse a este producto. Si el parámetro se omite o es nulo, se guardará con un elemento que representa el IVA trasladado del 16%, que es el impuesto más común. En caso de mandar explícitamente un arreglo vacío, se entiende que el producto está exento de impuestos.
+          description: |
+            Lista de impuestos que deberán aplicarse a este producto.
+
+            Resolución cuando `taxes` se omite o es `null`:
+            - `taxability` omitido o `"02"`: se agrega IVA trasladado 16%.
+            - `taxability` en `"01"`, `"03"`, `"04"`, `"05"`, `"06"` o `"08"`: se guarda `[]`.
+            - `taxability = "07"`: la solicitud es inválida; debes enviar al menos un IEPS de traslado y no incluir IVA.
+
+            Si envías `taxes` explícitamente, se usa el arreglo enviado.
           items:
             $ref: "#/components/schemas/BaseTax"
         local_taxes:
@@ -11144,6 +11153,9 @@ components:
             - "03"
             - "04"
             - "05"
+            - "06"
+            - "07"
+            - "08"
           description: |
             Código que representa si el bien o servicio es objeto de impuesto o no. Este atributo corresponde al campo "ObjetoImp" en el CFDI.
 
@@ -11154,8 +11166,18 @@ components:
             - `05`: Sí objeto de impuesto, IVA crédito PODEBI.
         taxes:
           type: array
-          default: IVA trasladado 16%
-          description: Lista de impuestos que deberán aplicarse a este producto. Si el parámetro se omite o es nulo, se guardará con un elemento que representa el IVA trasladado del 16%, que es el impuesto más común. En caso de mandar explícitamente un arreglo vacío, se entiende que el producto está exento de impuestos.
+          default:
+            - type: IVA
+              rate: 0.16
+          description: |
+            Lista de impuestos que deberán aplicarse a este producto.
+
+            Resolución cuando `taxes` se omite o es `null`:
+            - `taxability` omitido o `"02"`: se agrega IVA trasladado 16%.
+            - `taxability` en `"01"`, `"03"`, `"04"`, `"05"`, `"06"` o `"08"`: se guarda `[]`.
+            - `taxability = "07"`: la solicitud es inválida; debes enviar al menos un IEPS de traslado y no incluir IVA.
+
+            Si envías `taxes` explícitamente, se usa el arreglo enviado.
           items:
             $ref: "#/components/schemas/BaseTax"
         local_taxes: