api-partenaires
Comprendre les informations diverses et complémentaires d’un compte client ou fournisseur
[!IMPORTANT] Nous vous invitons préalablement à lire le guide Récupérer et travailler avec le plan comptable.
Ce guide a pour objectif de vous aider dans la récupération et la compréhension des informations complémentaires et diverses attachées aux comptes du plan comptable (principalement les comptes clients et fournisseurs).
Dans MyUnisoft le plan comptable est accessible à partir du menu: Paramètres > Dossier > Plan comptable.
Sélectionner par exemple un compte fournisseur et éditez-le (un pop-up devrait apparaitre).
Vous n’avez plus qu’à accéder à l’onglet secondaire “Info. complémentaires”.
Informations diverses
Les valeurs contenues dans la pop-up Divers sont aussi des informations complémentaires ce qui implique que dans la réponse JSON de l’api, ces valeurs sont contenues la propriété complementary_informations.
Toujours dans le retour JSON de l’api, les champs associés commencent tous par misc_: misc_language_id, misc_doubtful_id, misc_referent, misc_archived, misc_group.
[!IMPORTANT] À savoir que le champ
Compte douteux/misc_doubtful_idn’existe que pour les comptes clients (numéro de compte commençant par 41).
Voici un tableau des différentes langues disponibles associées à leur ID: | Label | id | |:—:|:—:| | Français | 1 | | Anglais | 2 | | Allemand | 3 | | Espagnol | 4 | | Autres | 999 |
API
Ces informations pourront être récupérées au sein de la clé complementary_informations retournée par la route https://api.myunisoft.fr/api/v1/account/v2?details=true&account_id=.
{
"das_2": false,
"label": "FOURNISSEURS IMMO.",
"closed": false,
"id_tva": null,
"presta": false,
"comment": null,
"intraco": false,
"analytics": false,
"account_id": 990,
"society_id": 3,
"exoneration": false,
"param_vat_id": null,
"ocr_threshold": 0,
"account_number": "4041700000",
"ocr_autovalidation": false,
"btp_autoliquidation": false,
"correspondance_label": null,
"id_compte_contrepart": null,
"correspondance_no_compte": null,
"complementary_informations": {
"ape": {
"id": 534,
"info": "Édition de logiciels applicatifs",
"label": "5829C-Édition de logiciels applicatifs",
"value": "5829C"
},
"tel": "+33655547180",
"city": "SAINTE GENEVIEVE DES BOIS",
"name": "MY UNISOFT",
"tel2": null,
"email": "gentilhomme.thomas@gmail.com",
"siren": "840143275",
"address": "GAI SEJOUR",
"comment": null,
"function": "Développeur API",
"lastname": null,
"typevoie": {
"lib": "Rue",
"id_type_voie": 9
},
"firstname": null,
"iban_list": [
{
"bic": "",
"rum": "",
"iban": "",
"document": null,
"first_prlv": false,
"etablissement": "",
"rum_date_signature": null,
"id_iban_compte_tiers": 11
}
],
"id_country": null,
"is_foreign": false,
"misc_group": null,
"profession": null,
"postal_code": "91700",
"contact_list": [
{
"tel1": "",
"tel2": "",
"email": "user@myunisoft.fr",
"ordre": 1,
"lastname": "random",
"firstname": "name",
"id_contact_compte_tiers": 1
}
],
"payment_type": {
"code": "CB",
"label": "Carte bleue",
"payment_type_id": 13
},
"misc_archived": false,
"misc_referent": null,
"address_number": "3",
"payment_type_id": 13,
"amount_type_paid": null,
"contact_lastname": "GENTILHOMME",
"misc_doubtful_id": null,
"misc_language_id": 1,
"payment_deadline": {
"label": "30 jours fin de mois",
"end_month": true,
"day_number": null,
"number_of_days": 30,
"id_payment_deadline": 3
},
"person_in_charge": "Cyril MANDRILLY",
"contact_firstname": "Thomas",
"indice_repetition": null,
"address_complement": null,
"id_payment_deadline": 3,
"id_info_compte_tiers": 10,
"type_info_compte_tiers": null
}
}
interface TypeScript pour la clé complementary_informations
```ts export interface ComplementaryInformations { ape?: Ape; tel?: string; city?: string; name?: string; tel2: null | string; email?: string; siren: string; address?: string; comment: null | string; function?: string; lastname: null | string; typevoie?: Typevoie; firstname: null | string; iban_list: IbanList[]; id_country?: number; is_foreign: boolean; misc_group: any; profession?: string; postal_code?: string; contact_list: ContactList[]; payment_type: PaymentType; misc_archived: boolean; misc_referent: any; address_number?: string; payment_type_id?: number; amount_type_paid: any; contact_lastname?: string; misc_doubtful_id: any; misc_language_id: number; payment_deadline: PaymentDeadline; person_in_charge?: string; contact_firstname?: string; indice_repetition?: string; address_complement?: string; id_payment_deadline?: number; id_info_compte_tiers: number; type_info_compte_tiers: any; } export interface ContactList { tel1: string; tel2: string; email: string; ordre: number; lastname: string; firstname: string; id_contact_compte_tiers: number; function: string; } export interface Ape { id: number; info: string; label: string; value: string; } export interface Typevoie { lib: string; id_type_voie: number; } export interface IbanList { bic: string; rum: string; iban: string; first_prlv: boolean; etablissement: string; rum_date_signature: null | string; id_iban_compte_tiers: number; document: any; } export interface PaymentType { code?: string; label?: string; payment_type_id?: number; } export interface PaymentDeadline { label?: string; end_month?: boolean; day_number: null | number; number_of_days?: number; id_payment_deadline?: number; } ```Contacts
Le contact principal est représenté par les champs suivants:
{
"tel": "+33655547180",
"tel2": null,
"email": "gentilhomme.thomas@gmail.com",
"function": "Développeur API",
"contact_firstname": "Thomas",
"contact_lastname": "GENTILHOMME"
}
Les contacts secondaires sont injectés dans le tableau contact_list
{
"contact_list": [
{
"tel1": "0655547180",
"tel2": "",
"email": "john.doe@unknown.com",
"ordre": 1,
"function": "CEO",
"lastname": "Doe",
"firstname": "John",
"id_contact_compte_tiers": 3
}
],
}
[!NOTE] Le tableau est trié avec la clé
ordre!
Pour la mise à jour des contacts, merci de suivre le guide suivant.
Réglements
Le délai de paiement peut être retrouvé avec la clé payment_deadline
{
"payment_deadline": {
"label": "30 jours fin de mois",
"end_month": true,
"day_number": null,
"number_of_days": 30,
"id_payment_deadline": 3
},
}
Les méthodes de réglements avec IBAN avec le tableau iban_list
{
"iban_list": [
{
"bic": "CCBPFRPP",
"rum": "",
"iban": "FR7610107001011234567890129",
"document": null,
"first_prlv": false,
"etablissement": "",
"rum_date_signature": null,
"id_iban_compte_tiers": 17
}
],
}