Xero : importer une entité

Description

Importe une entité de l’API Xero Accounting, limitée à l’organisation de la connexion, dans une table de projet via votre connexion Xero. Choisissez la connexion, le type d’entité et d’éventuels filtres ; l’étape récupère les enregistrements correspondants et les écrit, sans requête à rédiger.

Un seul type d’étape couvre onze entités, des données de référence (plan comptable, contacts, articles, taux de taxe, devises) aux enregistrements transactionnels (factures, notes de crédit, paiements, journaux manuels, transactions bancaires).

Configuration

Champ	Obligatoire	Remarques
Connexion Xero	Oui	La connexion Xero à utiliser pour la lecture.
Table cible	Oui	La table de projet dans laquelle les résultats sont écrits.
Type d’entité	Oui	L’entité à récupérer. Par défaut Factures.
Status	Non	Limite à une seule valeur Status de Xero, par exemple AUTHORISED ou PAID.
Date de début	Non	Borne inférieure YYYY-MM-DD sur le Date de l’entité.
Date de fin	Non	Borne supérieure YYYY-MM-DD sur le Date de l’entité.
Mis à jour après	Non	Envoyée comme date limite de modification : seules les lignes modifiées après cette date sont renvoyées. Vide, tout est récupéré.

Note

Mis à jour après est un filtre côté requête sans repère enregistré — PlaidCloud ne mémorise pas où s’est arrêtée la dernière exécution ; indiquez donc vous-même la date limite à chaque exécution pour obtenir un comportement incrémental.

Types d’entités

Type d’entité	Contenu
Plan comptable	Code de compte, nom, type, classe, type de taxe, statut, code de reporting.
Contacts	Clients et fournisseurs, avec leur statut, leur numéro de taxe et leur devise par défaut.
Factures	Factures de vente et d’achat, avec contact, dates, statut, totaux et montant dû.
Notes de crédit	Notes de crédit sur des ventes ou des achats, avec contact, date, statut et total.
Paiements	Paiements avec date, montant, statut et compte bancaire.
Journaux manuels	Libellé du journal, date et statut.
Transactions bancaires	Transactions de dépense et de réception, avec date, statut, total et indicateur de rapprochement.
Articles	Articles de stock et de service, avec indicateur de suivi et quantité en stock.
Catégories de suivi	Noms et statut des catégories de suivi.
Taux de taxe	Noms, types, statut et taux effectif des taux de taxe.
Devises	Codes et descriptions des devises.

Note

Toutes les entités ne documentent pas tous les filtres — Articles et Devises n’en acceptent aucun, et Plan comptable et Contacts acceptent un statut mais pas de plage de dates. Les champs de filtre restent activés pour chaque entité ; Xero rejette un filtre qu’une entité ne prend pas en charge, de sorte que l’étape signale l’erreur plutôt que de renvoyer un jeu de résultats erroné.

Attention

L’organisation provient de la connexion, pas de cette étape. Chaque requête Xero désigne une organisation, et la connexion la porte — il n’y a donc aucun champ d’organisation sur l’étape. Pour récupérer la même entité depuis une seconde organisation, créez une seconde connexion Xero qui pointe vers elle.

Voir aussi

• Étapes Xero
• Se connecter à Xero — procédure pas à pas
• Connecteur REST Xero