API docDigitales versión 4.0

A partir del 1 de abril de 2023 la versión 4.0 del CFDI y el complemento de recepción de pago 2.0 serán las únicas versiones válidas ante el SAT. Por lo que en docDigitales estamos trabajando en realizar estos cambios dentro de nuestro API docDigitales. Te platicamos de los cambios:

Cambios en la Factura

  • La versión del CFDI será 4.0
  • Será obligatorio establecer la dirección fiscal (código postal) del emisor y receptor.
  • Será obligatorio establecer el régimen fiscal del receptor.
  • El nombre del emisor y receptor deberá ser expresado en MAYÚSCULAS y debe coincidir con el inscrito en su RFC. Para verificarlo, consulta la constancia de situación fiscal, te decimos cómo aquí.
    • En el caso de una persona física se debe registrar: Nombre = MARTON ALEJANDRO SANZI FIERROR
    • En el caso de una persona moral se debe registrar: Nombre = LA PALMA AEIO
  • Se agrega nuevo uso CFDI S01 – Sin efectos fiscales, el uso P01 ya no será válido.
    Se agrega un nuevo atributo para expresar si el comprobante ampara una operación de exportación.
    • 01 – No aplica (Esta por defecto y es para la mayoría de los CFDI)
    • 02 – Definitiva con clave A1 (Requerirá el complemento comercio exterior)
    • 03 – Temporal
    • 03 – Definitiva con clave distinta a A1 o cuando no existe enajenación en términos del CFF
  • Nuevo nodo para comprobantes globales, añade información adicional para este tipo de comprobantes.
    • Periodicidad (01 – Diario, 02 – Semanal, 03 – Quincenal, 04 – Mensual, 05 – Bimestral)
    • Meses (01-12) Bimestral (13-18)
    • Año (No puede ser menor a 2021)
  • Se agrega nuevo atributo en los conceptos para expresar si es Objeto de Impuestos, este se debe indicar en cada producto.
    • 01 – No objeto de impuesto
    • 02 – Sí objeto de impuesto ( Requerido si existe uno o más impuestos)
    • 03 – Sï objeto de impuesto y no obligado al desglose
    • 04 – Sí es objeto de impuesto y no causa impuesto
  • Nuevo nodo para expresar si un concepto se hace en nombre de un tercero (A Cuenta de Terceros). En este nodo se puede expresar información del contribuyente tercero, a cuenta del que se realiza la operación. Conforme a la regla 2.7.1.3 de la Resolución Miscelánea Fiscal vigente.
    • Requiere expresar el RFC, Nombre, Domicilio Fiscal y Régimen Fiscal del tercero, para cada concepto a cuenta de un tercero.

Cambios en el Complemento Recepción de Pago

  • La versión del complemento será 2.0.
  • Los cambios del Factura también aplican para la recepción de pago.
  • El número de parcialidad ahora es un campo requerido.
  • El atributo Tipo de Cambio DR, es sustituido por Equivalencia DR.
  • Se agrega un nuevo nodo para expresar el monto total de los pagos, deben ser expresados en MXN.

Hemos trabajado en los cambios de las estructuras JSON tanto de la factura como de la recepción de pago. En la página de docDigitales encontrarás la estructura de la 3.3 de la factura y 1.0 de la recepción de pago, ya que aún está vigente al timbrar en el API. Una vez que cambiemos a la nueva versión se actualizará en la página. Te anexamos las nuevas estructuras:

Estructura JSON Factura

{
  "meta": {
    "empresa_uid": "759cce88f3",
    "empresa_api_key": "JUweI2kQIxvYCtXnJe7DiA",
    "ambiente": "S",
    "objeto": "factura"
  },
  "data": [
    {
      "datos_fiscales": {
        "certificado_pem": "",
        "llave_pem": "",
        "llave_password": ""
      },
      "cfdi": {
        "cfdi__comprobante": {
          "folio": "123",
          "fecha": "2022-05-25T12:12:12",
          "tipo_comprobante": "I",
          "lugar_expedicion": "21100",
          "forma_pago": "01",
          "metodo_pago": "PUE",
          "moneda": "MXN",
          "tipo_cambio": "1",
          "subtotal": "99.00",
          "total": "99.00",
          "exportacion": "01",
          "cfdi__informacion_global": {
            "periodicidad": "02",
            "meses": "02",
            "año": "2022"
          },
          "cfdi__emisor": {
            "rfc": "DDM090629R13",
            "nombre": "EMISOR TEST",
            "regimen_fiscal": "601"
          },
          "cfdi__receptor": {
            "rfc": "XAXX010101000",
            "nombre": "PÚBLICO EN GENERAL",
            "uso_cfdi": "S01",
            "domicilio_fiscal": "33146",
            "regimen_fiscal": "616"
          },
          "cfdi__conceptos": {
            "cfdi__concepto": [
              {
                "clave_producto_servicio": "01010101",
                "clave_unidad": "KGM",
                "cantidad": "1",
                "descripcion": "descripcion test",
                "valor_unitario": "99.00",
                "importe": "99.00",
                "unidad": "unidad",
                "no_identificacion": "KGM123",
                "objeto_imp": "02",
                "cfdi__impuestos": {
                  "cfdi__traslados": {
                    "cfdi__traslado": [
                      {
                        "base": "99.00",
                        "impuesto": "002",
                        "tipo_factor": "Exento"
                      }
                    ]
                  },
                  "cfdi__a_cuenta_terceros": {
                    "rfc": "XIQB891116QE4",
                    "nombre": "BERENICE XIMO QUEZADA",
                    "regimen_fiscal": "605",
                    "domicilio_fiscal": "21039"
                  }
                }
              }
            ]
          }
        }
      }
    }
  ]
}
  • Nota: En este ejemplo aparece el nodo “cfdi__a_cuenta_terceros” y “cfdi__informacion_global” juntos, esto no es correcto para el SAT. Solo es un ejemplo demostrativo.

Estructura JSON – Recepción de Pago

{
  "meta": {
    "empresa_uid": "",
    "empresa_api_key": "",
    "ambiente": "S",
    "objeto": "recepcion"
  },
  "data": [
    {
      "datos_fiscales": {
        "certificado_pem": "",
        "llave_pem": "",
        "llave_password": ""
      },
      "cfdi": {
        "cfdi__comprobante": {
          "folio": "P01",
          "serie": "",
          "fecha": "2022-02-08T07:49:46",
          "tipo_comprobante": "P",
          "lugar_expedicion": "06300",
          "moneda": "XXX",
          "subtotal": "0",
          "total": "0",
          "exportacion": "01",
          "cfdi__emisor": {
            "rfc": "CACX7605101P8",
            "nombre": "XOCHILT CASAS CHAVEZ",
            "regimen_fiscal": "605"
          },
          "cfdi__receptor": {
            "rfc": "XAXX010101000",
            "nombre": "Público en general",
            "uso_cfdi": "CP01",
            "domicilio_fiscal": "06300",
            "regimen_fiscal": "616"
          },
          "cfdi__conceptos": {
            "cfdi__concepto": [
              {
                "clave_producto_servicio": "84111506",
                "clave_unidad": "ACT",
                "cantidad": "1",
                "descripcion": "Pago",
                "valor_unitario": "0",
                "importe": "0",
                "objeto_imp": "01"
              }
            ]
          },
          "cfdi__complemento": {
            "pago20__pagos": {
              "pago20__totales": [
                {
                  "monto_total_pagos": "1.00"
                }
              ],
              "pago20__pago": [
                {
                  "fecha_pago": "2022-02-08T12:00:00",
                  "forma_pago": "03",
                  "moneda": "MXN",
                  "tipo_cambio": "1",
                  "monto": "1.00",
                  "rfc_emisor_ordenante": "",
                  "rfc_emisor_beneficiario": "",
                  "nombre_banco_ordenante": "",
                  "cuenta_ordenante": "",
                  "cuenta_beneficiario": "",
                  "tipo_cadena_pago": "",
                  "num_operacion": "",
                  "certificado_pago": "",
                  "cadena_pago": "",
                  "sello_pago": "",
                  "pago20__docto_relacionado": [
                    {
                      "id_documento": "5181DA40-22CD-4B8D-9AA1-CEA9B09F8AD0",
                      "serie": "",
                      "folio": "3",
                      "moneda_dr": "MXN",
                      "equivalencia_dr": "1",
                      "numero_parcialidad": "1",
                      "importe_pagado": "1.00",
                      "importe_saldo_anterior": "500.00",
                      "importe_saldo_insoluto": "499.00",
                      "objeto_imp_dr": "01"
                    }
                  ]
                }
              ]
            }
          }
        }
      }
    }
  ]
}

Esperamos que esta información haya sido de ayuda.

Estamos a tus órdenes en el número de atención a clientes (686) 520 0503 o bien en el correo electrónico  soporte.api@docdigitales.com. Visita nuestro sitio web www.docdigitales.com

Nuestro horario de atención es de 9:00 a 19:00 hora Centro.

Comparte Mail Icon
← Entrada siguienteEntrada anterior →