Seol Doiciméad

Sa chéim seo úsáidfidh tú an athrú send chun doiciméad a sheoladh le sínithe. Is é seo an oibríocht is coitianta i nDlíghníomhach Legalesign.

Riachtanais

Tá de dhíth ort:

• Token nó eochair API ó Fíordheimhniú leis an API
• An cabhrach graphql ó Thús tapa GraphQL
• ID grúpa — an fhoireann a bhfuil an doiciméad dílis di
• ID teimpléid — an teimpléad PDF le seoladh

Is féidir leat an dá cheann a fháil trí do ghrúpaí agus a dteimpléidí a chur faoi agallamh — féach ar an chéim roimhe seo.

Seol an doiciméad

index.js

const sendResult = await graphql(token, `
    mutation SendDocument($input: DocumentSendSettingsInput!) {
        send(input: $input)
    }
`, {
    input: {
        groupId: '<your-group-id>',
        templateId: '<your-template-id>',
        title: 'Test Document',
        recipients: [
            {
                firstName: 'Jane',
                lastName: 'Smith',
                email: 'jane@example.com',
                order: 0
            }
        ]
    }
});

console.log('Task ID:', sendResult.data.send);

Má tá tú ag iarraidh roleId a áireamh, déan fiosrú ar rólanna na teimpléid le template { roles { id signerIndex } } (féach ar an chéim roimhe seo).

Má tá an ionchur neamhbhailí, fillfidh an athrú earráid láithreach.

Má éiríonn leis an athrú, fillfidh sé ID tasc. Déantar próiseáil ar an doiciméad go asyncrónach.

Seiceáil stádas an tasc

Déan fiosrú ar an gceist task chun a fháil amach cathain a bheidh an seoladh críochnaithe:

index.js

const taskId = sendResult.data.send;

const status = await graphql(token, `
    query CheckTask($id: ID!) {
        task(id: $id) {
            data
            report {
                status
                batchId
                documents
                errors
            }
        }
    }
`, { id: taskId });

console.log(JSON.stringify(status, null, 2));

Déanaigí iniúchadh ar status.data.task.report?.status i do chliant. Nuair a éiríonn sé COMPLETED, tá críochnú cruthúcháin an doiciméid bainte amach. Má éiríonn sé FAILED, níor éirigh leis an seoladh go rathúil.

Sampla iomlán oibre

Seo an index.js iomlán a chomhcheanglaíonn na céimeanna go léir:

index.js

const GRAPHQL_ENDPOINT = 'https://graphql.uk.legalesign.com/graphql';
const TOKEN = '<token-or-api-key>';

async function graphql(token, query, variables = {}) {
    const response = await fetch(GRAPHQL_ENDPOINT, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'Authorization': `Bearer ${token}`
        },
        body: JSON.stringify({ query, variables })
    });
    const result = await response.json();
    if (result.errors) console.error('GraphQL errors:', result.errors);
    return result;
}

async function main() {
    const result = await graphql(TOKEN, `
        mutation SendDocument($input: DocumentSendSettingsInput!) {
            send(input: $input)
        }
    `, {
        input: {
            groupId: '<your-group-id>',
            templateId: '<your-template-id>',
            title: 'Test Document',
            recipients: [
                {
                    firstName: 'Jane',
                    lastName: 'Smith',
                    email: 'jane@example.com',
                    order: 0
                }
            ]
        }
    });

    console.log('Task ID:', result.data.send);
}

main().catch(console.error);

Céimeanna eile

• Cuir níos mó roghanna le do sheoladh — féach ar DocumentSendSettingsInput chun na réimsí go léir atá ar fáil a fheiceáil
• Seol chuig níos mó faighteoirí nó go seicheamhach — féach ar módhanna seolta mínithe
• Seol neart doiciméad ag an am céanna — féach ar sendBatch agus sendBulk
• Brabhsáil níos mó samplaí athraithe