Recuperación de Solicitud de Descarga Masiva Registrada Previamente
Esta transacción permite recuperar la información asociada a una solicitud de descarga masiva registrada previamente.
OBTENER_SOLICITUD_DM_SAT_HTML
El valor suministrado en el parámetro jsonData es el Id de la solicitud en cuestión; este valor fue obtenido en la transacción de registro REGISTRAR_SOLICITUD_DM_SAT_HTML explicada en el artículo anterior.
Ejemplo de valor para el parámetro jsonData (se muestra en varias líneas para que se entienda mejor, debe especificarse en una sola):
- {
17
}
Ejemplo de valor para el parámetro jsonData: 17
A continuación se muestra la manera en que debe realizarse la solicitud:
- <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://www.fact.com.mx/schema/ws">
<soap:Header/>
<soap:Body>
<ws:JsonServiceCall>
<ws:jsonData>{
17
}</ws:jsonData>
<ws:transactionName>OBTENER_SOLICITUD_DM_SAT_HTML</ws:transactionName>
<ws:token>wAw8LzeFYnhlw2Qc0/5MXwvO7OepjeLJd/jci7o5wxlQu5r19BZsJOIE+T1P7SOEHU95MWSyE+AMU=</ws:token>
</ws:JsonServiceCall>
</soap:Body>
</soap:Envelope>
RESPUESTA
Ejemplo de valor devuelto en Payload para solicitud previa (aunque se muestra plano, y en varias líneas, el valor de Payload viene codificado Base64):
- {
"Info": "[{\"Id\":17,
\"TaxID\":\"JES900109Q90\",
\"Servicio\":\"CFDIS\",
\"FechaInicial\":\"\\/Date(1552197600000)\\/\",
\"FechaFinal\":\"\\/Date(1552629599000)\\/\",
\"TipoSolicitud\":\"CFDI\",
\"TipoTaxID\":\"EMISOR\",
\"Identificador\":\"c87117f0-2f87-4906-b647-4dfcc16722a4\",
\"EnrolledTimeStamp\":\"\\/Date(1557805800000)\\/\",
\"EstadoSolicitud\":-10,
\"CodigoEstadoSolicitud\":\"5000\",
\"NumeroCFDIs\":41259,
\"CodEstatus\":\"5000\",
\"Mensaje\":\"Solicitud Aceptada\"}]",
"Files": "[{\"IdArchivo\":41,
\"IdentificadorArchivo\":\"C87117F0-2F87-4906-B647-4DFCC16722A4_01\",
\"EstadoArchivo\":-2,
\"CodEstatusArchivo\":\"5000\",
\"MensajeArchivo\":\"Solicitud Aceptada\"},
{\"IdArchivo\":42,
\"IdentificadorArchivo\":\"C87117F0-2F87-4906-B647-4DFCC16722A4_02\",
\"EstadoArchivo\":-2,
\"CodEstatusArchivo\":\"5000\",
\"MensajeArchivo\":\"Solicitud Aceptada\"},
{\"IdArchivo\":43,
\"IdentificadorArchivo\":\"C87117F0-2F87-4906-B647-4DFCC16722A4_03\",
\"EstadoArchivo\":-2,
\"CodEstatusArchivo\":\"5000\",
\"MensajeArchivo\":\"Solicitud Aceptada\"},
{\"IdArchivo\":44,
\"IdentificadorArchivo\":\"C87117F0-2F87-4906-B647-4DFCC16722A4_04\",
\"EstadoArchivo\":-2,
\"CodEstatusArchivo\":\"5000\",
\"MensajeArchivo\":\"Solicitud Aceptada\"},
{\"IdArchivo\":45,
\"IdentificadorArchivo\":\"C87117F0-2F87-4906-B647-4DFCC16722A4_05\",
\"EstadoArchivo\":-2,
\"CodEstatusArchivo\":\"5000\",
\"MensajeArchivo\":\"Solicitud Aceptada\"},
{\"IdArchivo\":46,
\"IdentificadorArchivo\":\"C87117F0-2F87-4906-B647-4DFCC16722A4_06\",
\"EstadoArchivo\":-2,
\"CodEstatusArchivo\":\"5000\",
\"MensajeArchivo\":\"Solicitud Aceptada\"}]"
}
En Payload se devuelven dos DataTables serializados de la manera que siempre se ha entregado al front para transacciones de este tipo (Funciones.ConvertDataTableTojSonString(dt)).
El primer DataTable, de nombre Info, devuelve toda la información disponible para la solicitud que se está recuperando; este DataTable siempre contiene un único registro.
El segundo DataTable, de nombre Files, devuelve toda la información disponible para cada uno de los archivos asociados a la solicitud de descarga; este DataTable puede tener de 0 a "n" registros.
La respuesta para una solicitud que no tuviera archivo tendría este formato (Files vacío):
- {
"Info": "[{\"Id\":15,
\"TaxID\":\"JES900109Q90\",
\"Servicio\":\"CFDIS\",
\"FechaInicial\":\"\\/Date(1552629600000)\\/\",
\"FechaFinal\":\"\\/Date(1554098399000)\\/\",
\"TipoSolicitud\":\"CFDI\",
\"TipoTaxID\":\"EMISOR\",
\"Identificador\":\"997c3c92-868f-44b4-b802-ef787048c159\",
\"EnrolledTimeStamp\":\"\\/Date(1557802500000)\\/\",
\"EstadoSolicitud\":5,
\"CodigoEstadoSolicitud\":\"5003\",
\"NumeroCFDIs\":0,
\"CodEstatus\":\"5000\",
\"Mensaje\":\"Solicitud Aceptada\"}]",
"Files": "[]"
}
A continuación, se explica el significado de la información que se devuelve en cada DataTable.
Info:
Id: Identifica, de manera única, la Solicitud, con este se puede dar seguimiento en otras transacciones.
TaxID: RFC propietario de la Solicitud de Descarga Masiva.
Servicio: Tipo de servicio de la Solicitud de Descarga Masiva (CFDIS, RETENCIONES).
FechaInicial: Fecha inicial de la Solicitud de Descarga Masiva.
FechaFinal: Fecha final de la Solicitud de Descarga Masiva.
TipoSolicitud: Tipo de solicitud de la Solicitud de Descarga Masiva (Metadata, CFDI).
TipoTaxID: Tipo de RFC de la Solicitud de Descarga Masiva (EMISOR, RECEPTOR).
Identificador: Identificador de la Solicitud de Descarga Masiva generado por el SAT; este no es el identificador único (lo es Id), porque una solicitud registrada en MYSuite pudiera no generar una en el SAT (por error o cualquier otro motivo); mientras la solicitud no sea procesada y además haya una respuesta positiva por parte del SAT, este campo no tendrá información.
EnrolledTimeStamp: Fecha de registro, en MYSuite, de la Solicitud de Descarga Masiva.
EstadoSolicitud: Estado de la Solicitud de Descarga Masiva:
1.- Registrada en MYSuite; pendiente por generar en el SAT (no existe aun Identificador).
2.-
Generada en el SAT con éxito (esto recuperó Identificador del SAT).
3.-
No hubo conexión al servicio del SAT o no hubo respuesta (caso TimeOut o cualquier otro problema); este código especifica error al consumir el servicio de generación de la Solicitud en el SAT.
4.-
Respuesta del SAT obtenida, pero con error (error devuelto en la respuesta del SAT).
5.-
No hubo conexión al servicio del SAT o no hubo respuesta (caso TimeOut o cualquier otro problema); este código especifica error al consumir el servicio de verificación de la Solicitud en el SAT.
10.-
Solicitud de Descarga terminada por completo (esto implica que además, todos los archivos asociados a la Solicitud, en caso de existir, fueron recuperados sin problema alguno).
11.-
Solicitud de Descarga terminada por completo en el SAT pero que no pudo ser terminada en MYSuite (estado para indicar que aun cuando para el SAT la solicitud está como terminada hubo algún error para culminar dicha solicitud en MYSuite, generalmente tiene que ver con la recuperación de alguno de los archivos asociados o con su subida a la nube).
Cualquier valor positivo es un código propio del SAT, devuelto en ; para la interpretación de cada caso remitirse a la documentación oficial acerca de los Servicios de Descarga Masivas, disponible en https://wwwmat.sat.gob.mx/consultas/42968/consulta-y-recuperacion-de-comprobantes-(nuevo).
Los códigos del 1 al 4 están asociados, todos, al proceso de solicitar al SAT el registro de la Solicitud ya existente en MYSuite. Código 5 está asociado al proceso de verificación de una solicitud ya registrada en el SAT. Códigos 10 y 11 son propios de la culminación en MYSuite de la Solicitud después que el SAT la reportó como terminada con éxito.
Esto explica el por qué, a pesar de tener la misma explicación, los códigos 3 y 5 no significan lo mismo.
CodigoEstadoSolicitud: Valor devuelto por el SAT en CodigoEstadoSolicitud en el proceso de verificación de la Solicitud; para la interpretación de cada caso remitirse a la documentación oficial acerca de los Servicios de Descarga Masivas, disponible en https://wwwmat.sat.gob.mx/consultas/42968/consulta-y-recuperacion-de-comprobantes-(nuevo)
NumeroCFDIs: Valor devuelto por el SAT en NumeroCFDIs en el proceso de verificación de la Solicitud.
CodEstatus: Valor devuelto por el SAT en CodEstatus en el proceso de generación o verificación de la Solicitud; para la interpretación de cada caso remitirse a la documentación oficial acerca de los Servicios de Descarga Masivas, disponible en https://wwwmat.sat.gob.mx/consultas/42968/consulta-y-recuperacion-de-comprobantes-(nuevo).
Mensaje: Valor devuelto por el SAT en Mensaje en el proceso de generación o verificación de la Solicitud o, en su defecto, uno indicado de manera interna por MYSuite para errores propios.
Files:
IdArchivo: Identifica, de manera única, un Archivo asociado a una Solicitud de Descarga Masiva, con este se puede dar seguimiento en otras transacciones.
IdentificadorArchivo: Identificador, generado por el SAT, de un Archivo asociado a una Solicitud de Descarga Masiva; aunque este valor pudiera haberse utilizado como identificador único, porque desde que se registra en MYSuite ya tiene valor, por analogía con la Solicitud hemos utilizado IdArchivo.
EstadoArchivo:
1.- Registrado en MYSuite; pendiente por descargar del SAT.
2.-
Descargado del SAT con éxito.
3.-
No hubo conexión al servicio del SAT o no hubo respuesta (caso TimeOut o cualquier otro problema); este código especifica error al consumir el servicio de descarga del Archivo del SAT.
4.-
Respuesta del SAT obtenida, pero con error (error devuelto en la respuesta del SAT).
5.-
Error inesperado (puede estar asociado a la subida del archivo a la nube o cualquier otro error no controlado después de haber recuperado el archivo del SAT).
6.-
Descargado previamente (indica que el archivo ya existe en nuestra nube, normalmente asociado a un error previo no controlado después de haberse descargado del SAT y subido a la nube).
CodEstatusArchivo: Valor devuelto por el SAT en CodEstatus en el proceso de descarga del Archivo; para la interpretación de cada caso remitirse a la documentación oficial acerca de los Servicios de Descarga Masivas, disponible en https://wwwmat.sat.gob.mx/consultas/42968/consulta-y-recuperacion-de-comprobantes-(nuevo).
MensajeArchivo: Valor devuelto por el SAT en Mensaje en el proceso de descarga del Archivo o, en su defecto, uno indicado de manera interna por MYSuite para errores propios.
Notas para tener en cuenta:
· No se permite recuperar una solicitud que pertenece a un RFC diferente al que realiza la transacción; en ese caso el sistema generará un error.