ats

Genera el ATS del período, lo valida y lo archiva

Serializa el anexo, lo valida contra las reglas de la ficha y contra el XSD oficial, guarda el XML en el almacenamiento de objetos con su sha256 y archiva el snapshot en declaraciones_hechas (código ATS, período aaaa-mm o aaaa-S1/aaaa-S2). Si el anexo no valida responde 400 con el informe y no guarda nada; forzar: true lo guarda igual y lo deja marcado como forzado. No devuelve el XML: para eso está GET /ats/{periodo}/descargar. Requiere el módulo ats.

post/ats/generar

Request

  • Base URL: https://contadeo.com/api
  • URL: https://contadeo.com/api/ats/generar
  • Auth: HTTP bearer

Request body

emisorIdstring uuid required
aniointeger required
mesinteger

Anexo mensual. Se ignora si viene semestre.

semestre1 | 2

Anexo semestral del RIMPE: 1 = enero-junio, 2 = julio-diciembre. Es una opción del contribuyente, no un default del régimen, y no se persiste: se pide en cada generación.

forzarboolean

Guarda el anexo aunque no valide, marcándolo como forzado y dejando la declaración en estado borrador.

excluir332boolean

Con true, las compras sin retención de renta salen sin el concepto 332. La ficha técnica pide reportarlo; el XSD admite el anexo sin él y la regla N10 lo avisa.

excluirRetencionesElectronicasboolean

Con false, lo que cada cliente retuvo se reporta en ventas (valorRetIva, valorRetRenta). Por defecto van en 0.00, como indica la ficha técnica para las retenciones con comprobante electrónico; la regla N11 dice cuántos comprobantes quedan fuera.

Response

Anexo generado y archivado

hashXmlstring

sha256:<hex> del XML archivado.

generadoAtstring date-time
estado'listo' | 'borrador'

listo si el anexo valida (cifras congeladas); borrador si se forzó.

forzadoboolean
totalesobject

Totales de cabecera y conteos por sección, tal como quedaron en el snapshot.

informeobject

Informe de las reglas V1-V17 y N1-N9, igual que en el borrador.

xsdobject
exclusionesobject[]
brechasobject[]

Changes

No recorded changes to this operation across all 2 revisions of this API.