LOOKUP_ISSUED_INTERNAL_ID

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 el solicitado. El Número Interno es empleado por muchos sistemas administrativos con el fin de plasmar en el comprobante un control interno que solo es válido para su sistema.

Su escenario más común de uso es cuando se hace una solicitud CONVERT_NATIVE_XML a MYSuite y no se recibe respuesta.

En esos casos se desconoce si la solicitud llegó o no a MYSuite. Para saberlo (ya que no se sabe qué folio pudo haber asignado MYSuite), se pregunta por el número interno que fue asignado por el sistema administrativo y por tanto se conoce a priori.

Es decir, los pasos al ejecutar CONVERT_NATIVE_XML y recibir la respuesta en el elemento Result, si es true, todo estuvo OK.

Si dio otra respuesta que no es gestionada por tu sistema o nuestro Web Service como TimeOut, entonces antes de volver a generar el archivo con CONVERT_NATIVE_XML, llamar a la transacción LOOKUP_ISSUED_INTERNAL_ID, si dio mayor que 0 en el elemento, por ejemplo: "responseData1Field": "1", entonces las transacción anterior se hizo sin problemas, por tanto no se ejecuta CONVERT_NATIVE_XML nuevamente.


Solicitud




Valores
  1. {
      "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: Número Interno

En Data2: Sucursal (Opcional, si se especifica, también será tomado como parámetro en la búsqueda del comprobante)

Data3: Si está vacío se considerará el año actual, si el CFDI que buscan es de un año anterior debe especificarse el año. Ejemplos: 2017, 2018, 2019.

  1. {
      "Requestor": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
      "Transaction": "LOOKUP_ISSUED_INTERNAL_ID",
      "Country": "MX",
      "Entity": "JES900109Q90",
      "User": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
      "UserName": "MX.JES900109Q90.jan",
      "Data1": "CA_1_3",
      "Data2": "ABB",
      "Data3": ""
    }

Respuesta
  1. {
       "requestField":    {
          "requestorField": "00000000-0000-0000-0000-000000000000",
          "requestorNameField": null,
          "requestorActiveField": true,
          "transactionField": 50,
          "countryField": "MX",
          "entityField": "JES900109Q90",
          "userField": "00000000-0000-0000-0000-000000000000",
          "userNameField": "MX.JES900109Q90.jan",
          "idField": "5f33ba48-df74-40fe-8fc4-6bfa7978b497",
          "timeStampField": "2020-06-25T16:02:57.0054867-05:00"
       },
       "responseField":    {
          "resultField": true,
          "timeStampField": "2020-06-25T16:02:57.0211132-05:00",
          "lastResultField": "",
          "codeField": 1,
          "descriptionField": "",
          "hintField": "",
          "dataField": " 781 5f33ba48-df74-40fe-8fc4-6bfa7978b497",
          "processorField": "TEST-BACK02",
          "identifierField": null,
          "batchIdentifierField": null
       },
       "responseDataField":    {
          "responseData1Field": "1",
          "responseData2Field": "Estructura XML codificada en Base64 con el 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:
  1. <DocsFoundBy internalId="CA_1_3" count="1" year="">
    <doc pos="1">
    <ctry>MX</ctry>
    <taxId>JES900109Q90</taxId>
    <uuid>3a39d327-5b80-4f35-b59e-680b280d3ccc</uuid>
    <branch>ABB</branch>
    <batch>ABB</batch>
    <serial>850</serial>
    <issued>2020-06-12T09:31:35</issued>
    <cancelled/>
    <kind>1</kind>
    <currency>MXN</currency>
    <total>117198.000000</total>
    </doc>
    </DocsFoundBy>

Si la cantidad de comprobantes encontrados es 0 (cero), en responseData1Field devuelve un 0 (cero), y en responseData2Field no se devuelve nada.

    • Related Articles

    • 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

      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_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 ...