DClara API

Referencia de la API

Usa nuestra API para automatizar la creación de declaraciones previas de compraventa directamente desde tu sistema.

Autenticación

La API de DClara utiliza tokens de Sanctum para la autenticación. Debes incluir el token en la cabecera Authorization de cada petición HTTP.

Authorization: Bearer {TU_TOKEN_API}

Puedes generar tus tokens desde la sección de API en los ajustes de tu perfil.

Endpoints

POST /api/files

Crea un documento de enajenación completo (secciones A a G) y devuelve el archivo en el layout oficial de DeclaraNOT.

Estructura del Body (JSON)

El cuerpo reproduce las secciones A a G del formulario. Las secciones pagos, enajenantes, adquirentes y copropietarios son arreglos: cada elemento se convierte en una línea -grid del archivo. Las fechas se envían como aaaa-mm-dd y se exportan como dd/mm/aaaa.

Sección Línea del layout Obligatorio Campos
configuracion Configuracion No ejercicio, tipo_declaracion, fecha_operacion. Si se omiten se deducen de la escritura.
operacion 900001 Sí num_esc, fecha_escritura, tipo_inmueble, tipo_otro_inmueble, valor_avaluo.
pagos[] 900002 Sí monto_operacion, tipo_pago, institucion_financiera, numero_cuenta, tipo_otro_pago.
enajenantes[] 900003 Sí tipo, rfc, nombre, apellido_paterno, apellido_materno, curp, razon_social, nacionalidad, fecha_nacimiento, documento_oficial, num_folio.
informativos 900004 Sí obtuvo_ingresos_exentos_3anios, monto_operacion, impuesto_retenido.
adquirentes[] 900005 Sí Mismos campos que enajenantes.
pago_calculo 900006 Sí ingresos_enajenacion, ingresos_exentos, ingresos_exentos_sismo_2017, deducciones_autorizadas, anios_entre_adquisicion_venta, isr_pagado_federacion, num_operacion_pago_federacion, fecha_pago_federacion, isr_pagado_entidad, num_operacion_pago_entidad, fecha_pago_entidad.
copropiedad 900010 / 900013 / 900009 Sí pregunta_copropiedad_o_conyugal, existe_representante_legal, representante_legal_rfc.
copropietarios[] 900007 / 900011 Solo con copropiedad rfc, porciento_correspondiente, ingreso_por_la_enajenacion, total_deducciones_autorizadas, ganancia_o_perdida, isr_pagado_federacion, isr_pagado_entidad_federativa. Los porcientos deben sumar 100.

Campos calculados

No envíes ganancia, ganancia_acumulable, ganancia_no_acumulable, total_isr_pagado ni total_porcentaje: el servidor los calcula y sobrescribe cualquier valor recibido.

Ejemplo de Petición

curl -X POST https://www.dclara.51x.mx/api/files \
  -H "Authorization: Bearer TU_TOKEN_API" \
  -H "Content-Type: application/json" \
  -d '{
    "configuracion": { "ejercicio": "2026", "tipo_declaracion": "001" },
    "operacion": {
        "num_esc": "21221",
        "fecha_escritura": "2026-03-25",
        "tipo_inmueble": "1",
        "valor_avaluo": "1500000"
    },
    "pagos": [
        { "monto_operacion": "100", "tipo_pago": "3", "institucion_financiera": "102", "numero_cuenta": "8192891289" }
    ],
    "enajenantes": [
        { "tipo": "1", "rfc": "MOGC881102TB4", "nombre": "Juan", "apellido_paterno": "Perez", "apellido_materno": "Lopez" }
    ],
    "informativos": { "obtuvo_ingresos_exentos_3anios": "2" },
    "adquirentes": [
        { "tipo": "2", "razon_social": "Empresa Prueba", "nacionalidad": "TC" }
    ],
    "pago_calculo": {
        "ingresos_enajenacion": "12345",
        "ingresos_exentos": "12",
        "deducciones_autorizadas": "3",
        "anios_entre_adquisicion_venta": "13",
        "isr_pagado_federacion": "2",
        "isr_pagado_entidad": "3"
    },
    "copropiedad": { "pregunta_copropiedad_o_conyugal": "2", "existe_representante_legal": "2" },
    "copropietarios": []
}'

Respuesta Exitosa (201 Created)

{
    "message": "Archivo creado correctamente",
    "filename": "21221_a1b2c3d4.txt",
    "path": "users/1/21221_a1b2c3d4.txt",
    "url": "/storage/users/1/21221_a1b2c3d4.txt",
    "download_url": "https://www.dclara.51x.mx/mis-archivos/21221_a1b2c3d4/descargar"
}

Archivo generado

El archivo queda en el layout oficial de DeclaraNOT, listo para cargarse:

Configuracion:2026|001|035|24|25/03/2026
900001-DatosOperacion:21221|25/03/2026|1|
900002-DatosPago-grid:100|3|102|8192891289|
900003-DatosEnajenante-grid:1|MOGC881102TB4|Juan|Perez|Lopez||||||
900004-DatosInformativos:2||
900005-DatosAdquiriente-grid:2|||||Empresa Prueba|TC|||
900006-DatosPago-grid:12345|12||3|12330|13|948.46|11381.54|2||||3||5

Formato anterior

Las integraciones que envían el cuerpo plano (num_esc, fecha_firma, tipo_inm, valor_avaluo, valor_operacion, fecha_escritura) siguen funcionando: se mapean a la sección A y a un primer pago, y el resto del documento queda vacío para completarse después desde la aplicación.