LOOKUP_ISSUED_BATCH_AND_SERIAL
Busca todos los CFDI´s que se encuentren por Serie y Folio que haya puesto el cliente en el XML nativo de MYSuite desde el ERP del Emisor o en su defecto, en la asignación que se encuentra desde el Portal Web de MYSuite.
Este método permite conocer los comprobantes almacenados en MYSuite que coincidan con la Serie y Folio indicados en la solicitud, puede existir más de un documento del mismo Emisor con la misma Serie y Folio ya que estos no son los elementos de unicidad de la base de datos, como sí lo es el folio fiscal (UUID).
Este método es de utilidad para aquellos sistemas administrativos que lleven el control por Serie y Folio en lugar de emplear el verdadero Folio Fiscal (UUID). En estos casos, la unicidad por Serie y Folio debe ser garantizada por el sistema administrativo.
Solicitud
Request URL: https://api.mysuitetest.com/RequestTransaction
Valores
-
{
"Requestor": "string",
"Transaction": "string",
"Country": "string",
"Entity": "string",
"User": "string",
"UserName": "string",
"Data1": "string",
"Data2": "string",
"Data3": "string"
}
Descripción de Parámetros:
Requestor: Es un dato de tipo GUID que proporciona MYSuite y está relacionado con la seguridad de la transacción así como procesos de autenticación y autorización.
Transaction: Corresponde al método que desee invocar.
Country: Corresponde a la abreviatura del país, en este caso MX.
Entity: Identifica el RFC de quién realiza la solicitud, en este caso, corresponde a la empresa que realiza la transacción desde su ERP o sistema de gestión de facturas. Si es un cliente CFDI + Timbrado, en el ambiente de prueba debe utilizar el RFC JES900109Q90
User: Repetir la información del Requestor.
UserName: Está considerado para poder indicar el usuario del ERP y que el cliente pueda conocer quién realizó la solicitud, se define por la combinación de varios parámetros de la siguiente manera:
Country.Entity.Usuario_ERP
Ejemplos:
MX.ETN040506RB3.jacinto
MX.ETN040506RB3.mendez
La adopción de un usuario u otro está en dependencia de las necesidades del cliente en cuanto a la división de sus procesos de facturación en sucursales, departamentos o simplemente identificar cada actividad de facturación por empleado.
Data1, Data2 y Data3: En función del método a utilizar se deberá contemplar el llenado de estos nodos conforme corresponda.
En Data1: Serie
En Data2: Folio
Data3: Sucursal (Opcional, si se especifica, también será tomado como parámetro en la búsqueda del comprobante)
-
{
"Requestor": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
"Transaction": "LOOKUP_ISSUED_BATCH_AND_SERIAL",
"Country": "MX",
"Entity": "JES900109Q90",
"User": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
"UserName": "MX.JES900109Q90.jan",
"Data1": "ABB",
"Data2": "860",
"Data3": "ABB"
}
Respuesta
-
{
"requestField": {
"requestorField": "00000000-0000-0000-0000-000000000000",
"requestorNameField": null,
"requestorActiveField": true,
"transactionField": 62,
"countryField": "MX",
"entityField": "JES900109Q90",
"userField": "00000000-0000-0000-0000-000000000000",
"userNameField": "MX.JES900109Q90.jan",
"idField": "bb6849e8-2307-4e16-9b01-4608eb1da1bc",
"timeStampField": "2020-06-26T10:42:43.8023685-05:00"
},
"responseField": {
"resultField": true,
"timeStampField": "2020-06-26T10:42:44.3336146-05:00",
"lastResultField": "",
"codeField": 1,
"descriptionField": "",
"hintField": "",
"dataField": " 142 bb6849e8-2307-4e16-9b01-4608eb1da1bc",
"processorField": "TEST-BACK02",
"identifierField": null,
"batchIdentifierField": null
},
"responseDataField": {
"responseData1Field": "1",
"responseData2Field": "XML codificado en B64 con detalle de los documentos encontrados",
"responseData3Field": "",
"responseDataSetField": null
}
}
responseData1Field: Cantidad de documentos encontrados
responseData2Field: En base 64 se devuelve un XML con el detalle de los documentos encontrados, no los documentos en si.
La estructura XML decodificada trae:
-
<DocsFoundBy batch="ABB" serial="860" count="1" year="2020"><doc pos="1"><ctry>MX</ctry><taxId>JES900109Q90</taxId><uuid>94e4a686-37e7-4d8a-a849-101adef74fff</uuid><branch>ABB</branch><batch>ABB</batch><serial>860</serial><issued>2020-06-18T09:47:11</issued><cancelled/><kind>1</kind><currency>MXN</currency><total>116.000000</total></doc></DocsFoundBy>
Si la cantidad de comprobantes encontrados es 0 (cero), en ResponseData1 devuelve un 0 (cero), y en ResponseData2 no hay nada.
Related Articles
LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL
Busca todos los CFDI´s que se encuentren por Serie y Folio que haya puesto el cliente en el XML nativo de MYSuite desde el ERP del Emisor o en su defecto, en la asignación que se encuentra desde el Portal Web de MYSuite. Este método permite conocer ...LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL
Busca todos los CFDI´s que se encuentren por Serie y Folio que haya puesto el cliente en el XML nativo de MYSuite desde el ERP del Emisor o en su defecto, en la asignación que se encuentra desde el Portal Web de MYSuite. Este método permite conocer ...LOOKUP_ISSUED_INTERNAL_ID
Busca todos los CFDI´s que se encuentren emitidos con el número interno que haya puesto el cliente en el XML nativo de MYSuite desde su ERP. Este método devuelve la cantidad de comprobantes almacenados en MYSuite cuyo Número Interno coincide con el ...LOOKUP_ISSUED_INTERNAL_ID
Esta transacción está destinada al control de la no duplicidad en los comprobantes. Uno de los parámetros de esta transacción es el número interno que corresponde a un único ID de alguna transacción, llamada, operación o registro en el ERP de los ...LOOKUP_ISSUED_INTERNAL_ID
Busca todos los CFDI´s que se encuentren por el número interno que haya puesto el cliente en el XML nativo de MYSuite para con el ERP del Emisor. Este método devuelve la cantidad de comprobantes almacenados en MYSuite cuyo Número Interno coincide con ...