Therefore™ Help

Crear una cuenta de PISTE

 

•Vaya a https://developer.aife.economie.gouv.fr/en/component/apiportal/registration y cree una cuenta. Se necesita una cuenta de PISTE para establecer una conexión segura entre Therefore™ y el portal de Chorus. Permite acceder a un conjunto limitado de funciones de API utilizando las credenciales de PISTE proporcionadas.

•Inicie sesión en este sitio web: https://developer.aife.economie.gouv.fr/en/apps

 

Configurar la aplicación

Una cuenta de PISTE hospeda varias aplicaciones (de producción y/o espacio aislado). Cada aplicación tiene sus propios Id. y secreto únicos, que se utilizan en la configuración de Azure Function. Cree una aplicación de PISTE para cada una de esas estructuras.

 

 

 

 

Cómo obtener un ID y un secreto de PISTE

 

Elija la aplicación TFO_Piste_App en la pestaña “Applications”. Vaya a Details en la pestaña de credenciales de OAuth.
El ClientID es el Id de la aplicación actual. Haga clic en “View secret” para mostrar el secreto.

 

 

 

 

 

 

 

Cómo conectar una cuenta de Chorus a una cuenta de PISTE

 

Añada la pestaña “EDI and API connections” siguiendo estos pasos.

a)Inicie sesión en el portal de Chorus con su cuenta principal (no con su cuenta técnica). Vaya a la pestaña Manager Activities. Despliegue “List of areas of the structure” y haga clic en el botón “+Add areas”.

b)Seleccione las casillas “Sulvl des flux” y “Raccordement EDI et API” en la columna Modify (que también servirá más adelante). Haga clic en Validate.

 

c)Vaya a la pestaña “EDI and API connections” en el portal Chorus pro. Acceda a “Manage API connection”.

d)Vaya a "Declaration API connection request by PISTE”.

e)Elija la estructura correspondiente a usted. Seleccione el nombre de la aplicación PISTE en el grupo “PISTE application name”. Seleccione “User of an internal application” en el grupo “Type of use”. Se necesita una aplicación aparte para cada estructura.

En “Technical Contact” introduzca los detalles del responsable de esta conexión de API.

 

 

Crear un nuevo flujo de trabajo para Chorus Upload

 

Cree un flujo de trabajo para la tarea de carga. El gráfico siguiente muestra un ejemplo básico de flujo de trabajo.

Un flujo de trabajo consta de dos tareas de flujo de trabajo.

1.Tarea Incrustar datos de índice

Esta tarea se encarga de incrustar xml en un archivo PDF/A-3 (la tarea de flujo de trabajo convertirá un PDF en un PDF/A-3).

2.Tarea Función de llamada

Esta tarea desencadena Azure Function con argumentos como cuenta técnica y contraseña de Chorus Pro. Azure Function seguirá los pasos siguientes:

a)Obtener el token de OAuth de PISTE.

b)Cargar un archivo en Chorus Pro.

c)Comprobar si Chorus ha cargado y procesado correctamente el archivo.

d)Mostrar errores que se han producido durante el procesamiento/carga en el historial de WF y en el portal de Chorus en “Data Flow Overview”.

e)Si el estado de la factura es “Integrated”, se guardará en “Issued Invoices”, accesible a través de la pestaña “Search” o “Dashboard”.

 

Configurar tareas de flujo de trabajo

 

Tarea Incrustar datos de índice

Si hay varias facturas que corresponden a un documento de Therefore™, combínelas en un archivo mediante la casilla “Combinar en un archivo”. En caso contrario, Chorus solo cargará la primera factura. Tenga en cuenta que solo se pueden enviar a Chorus archivos de hasta 90 MB de tamaño.

 

Utilice la siguiente configuración:

-Perfil: “Factur –X”

-Nivel de cumplimiento: “EN16931”

-Nombre de XML incrustado: Opción predeterminada (factur-x.xml)

Haga clic en “Cargar XML de plantilla…” y elija el archivo xml adjunto a continuación (se requiere xml como mínimo). Contiene la información necesaria que se facilitará en “Datos de índice como XML (basados en plantilla)”.

 

Rellene los siguientes datos después de cargar la plantilla xml. Utilice los valores de Datos de índice de Categoría. Si se deja algún campo vacío, se rellenará con valores del xml de plantilla.

Utilice la siguiente configuración.

1.urn:factur-x.eu:1p0:minimum

2.Número único de factura. Recuerde dejarlo como cadena.

3. 380

4.Fecha y hora de emisión. Para asegurarse de que la fecha está en el formato correcto, añada el formato en el xml. Si utiliza el factur-x.xml que se adjuntaba más arriba, no necesitará realizar cambios.
<udt:DateTimeString format="102">

5.Nombre del vendedor

6.Número de SIRET del vendedor. Debe tener 14 dígitos. Si el SIRET tiene menos de 14 dígitos, añada 0 delante del número (por ejemplo, 123 => 00000000000123). El número debe mantenerse como cadena.

7.ID del país (por ejemplo, FR para Francia)

8.Nombre del comprador

9.Número de SIRET del comprador. Debe tener 14 dígitos. Si el SIRET tiene menos de 14 dígitos, añada 0 delante del número (por ejemplo, 123 => 00000000000123). El número debe mantenerse como cadena.

10.ID del país (por ejemplo, FR para Francia)

11.Número de pedido o número de contrato. Este número debe tener exactamente 10 dígitos. Solo es obligatorio si “Numéro d’engagement obligatoire :” se establece como Oui para la empresa en la que está realizando la búsqueda https://communaute.chorus-pro.gouv.fr/annuaire-des-entites-publiques-destinatrices-de-factures/?lang=en

12.Debe estar vacío

13.Código de moneda de la factura (por ejemplo, EUR para Euro)

14.Importe sin IVA

15.IVA

16.Importe con IVA

17.Importe a pagar de la factura

 

 

En la plantilla factur-x.xml mínima hay otro campo, BuyerReference.

 

 

Para obtener más información sobre Factur-X, consulte la documentación siguiente:

Referencia de Factur-X

Tarea Función de llamada

URL de solicitud:

https://tfochorusupload.azurewebsites.net/api/v1/ChorusUpload

cpro_account y cpro_password son la cuenta tecnica y la contraseña de Chorus pro.
piste_account y piste_password son la cuenta y la contraseña de PISTE.

Esta Azure Function solo estará disponible desde TFO EU.
 

 

 

Errores comunes

 

Error: El ID de ExchangedDocument ya existe en su estructura de Chorus.

Solución: Compruebe si el documento ya está cargado (a veces se puede llamar dos veces a Azure Function para el mismo documento). Si no es así, cambie el ID de ExchangedDocument.

 

Error: El número de SIRET del vendedor o del comprador tiene un número no válido de dígitos (más o menos de 14).

Solución: Si el SIRET tiene menos de 14 dígitos, añada ceros delante del número.

Por ejemplo, si el SIRET es 12345. Conviértalo en 00000000012345.

 

Error: El número de SIRET del vendedor o del comprador no existe en Chorus.

Solución: Compruebe si el SIRET es correcto aquí. Indique el nombre/SIRET de la empresa y compruebe si coincide.
https://communaute.chorus-pro.gouv.fr/annuaire-des-entites-publiques-destinatrices-de-factures/?lang=en

 

Error: No se han rellanado todos los campos necesarios.

Solución: Rellene los campos necesarios. Si los campos están rellenos, compruebe si

el ID de GuidelineSpecifiedDocumentContextParameter es urn:factur-x.eu:1p0:minimum y si se ha utilizado el archivo xml correcto.

 

Error: "Please contact your administrator to set/configure PISTE credentials" (Contacte con el administrador para establecer/configurar credenciales de PISTE) en historial de WF.

Solución: Póngase en contacto con su administrador. En caso de TFO, póngase en contacto con el soporte técnico de Therefore.