Ինտեգրացիաներ

Փոխանակում 1C-ի հետ՝ պատրաստի մշակում

1C ծրագրավորող պետք չէ։ «Dvorum. փոխանակում 1C-ի հետ» մշակումն ուղարկում է տեխնիկական աջակցությունը, միացնում է հաշվապահը։

1. Մոդերատորը թողարկում է թոքեն օբյեկտի կարգավորումներում՝ «Վճարում» → «Ինտեգրացիա 1C-ի հետ»։
2. Հաշվապահը բացում է մշակումը 1C-ում, տեղադրում թոքենը և ընտրում ամիսը։
3. Սեղմում է «Փոխանակել». ցուցմունքները գալիս են աղյուսակով, հաշվեգրումներն ու վճարումները գնում են Dvorum ծառայություն։ Փոխանակման մատյանում երևում է, թե ինչն է ընդունվել, ինչը՝ ոչ և ինչու։
4. Որպեսզի փոխանակումն ընթանա ինքնաբերաբար, մշակումը միացնում են «Լրացուցիչ հաշվետվություններ և մշակումներ» բաժնում և սահմանում ժամանակացույց՝ օրինակ՝ ամեն օր ժամը 7:00-ին։

Հաշվեգրումներն ու վճարումները մշակումն ինքն է վերցնում «1C:Accounting 3.0» փաստաթղթերից։ 1C-ի այլ ծրագրերի համար, օրինակ՝ կոմունալ տնտեսության, վերցնում է հաշվետվությունից պահպանված Excel ֆայլից։ Վճարողին երկու համակարգն էլ ճանաչում են պայմանագրի համարով։

Վեբհուքեր՝ ինչպես են կառուցված

Օբյեկտի մոդերատորը հասցե է ավելացնում կարգավորումների «Ինտեգրացիաներ» ներդիրում, ընտրում իրադարձությունները և ստանում ստորագրության գաղտնաբառ։ Հետո յուրաքանչյուր իրադարձություն գնում է POST հարցումով՝ JSON-ով։

Իրադարձություններ

request.created

Նոր հայտ

request.status_changed

Հայտի կարգավիճակի փոփոխություն

payment.received

Վճարման մուտքագրում

pass.created

Անցագիրը տրվել է

pass.entered

Մուտք կամ անցում անցագրով

pass.exited

Ելք կամ դուրս գալ անցագրով

tenant.moved_in

Վարձակալի մուտք

tenant.moved_out

Վարձակալի հեռացում

payment.deleted

Վճարումը չեղարկվել է

pass.cancelled

Անցագիրը չեղարկվել է

bill.created

Նոր հաշիվ

request.rated

Կատարված հայտի գնահատական

request.sla_breached

Հայտը դուրս է եկել ժամկետից

Հաղորդագրության մեջ չկան անուններ, հեռախոսներ, փոստեր և համարանիշեր։ Տարածքը փոխանցվում է համարով (տուն, գրասենյակ, բնակարան), կազմակերպությունը՝ անվանմամբ, մարդիկ՝ ոչ մի կերպ։ Մանրամասները բացվում են քարտի հղումով։

Հաղորդագրության ձևաչափ

id դաշտը նույնն է մեկ իրադարձության բոլոր կրկնություններում. դրանով ստացողը զտում է կրկնօրինակները։

POST https://your-crm.example/hook
Content-Type: application/json
X-Dvorum-Event: request.status_changed
X-Dvorum-Delivery: 66f1c0e2a9b3d4e5f6a7b8c9
X-Dvorum-Signature: t=1758795300,v1=5f2b…

{
  "id": "66f1c0e2a9b3d4e5f6a7b8c0",
  "type": "request.status_changed",
  "createdAt": "2026-09-25T10:15:00.000Z",
  "place": { "id": "…", "name": "…" },
  "data": {
    "request": {
      "id": "…",
      "title": "…",
      "status": "IN_PROGRESS",
      "category": { "key": "plumbing", "name": null },
      "house": { "id": "…", "name": "312", "building": "A", "floor": 3 },
      "zone": null,
      "tenant": { "id": "…", "name": "…" },
      "planned": false,
      "createdAt": "2026-09-25T09:02:11.000Z",
      "url": "https://dvorum.com/requests/…"
    },
    "from": "ACCEPTED",
    "to": "IN_PROGRESS"
  }
}

Ստորագրություն

X-Dvorum-Signature վերնագիրը պարունակում է t ժամանակային նշագիր և v1 ստորագրություն՝ HMAC-SHA256 «t.մարմին» տողից՝ գաղտնաբառով։ Ստուգեք ստորագրությունը մարմնով՝ այն տեսքով, որով եկել է, մինչև JSON-ի վերլուծելը, և մերժեք հինգ րոպեից հին նշագրերը։

import crypto from "node:crypto";

function verify(secret, header, rawBody) {
  const sig = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${sig.t}.${rawBody}`)
    .digest("hex");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}

Առաքում և կրկնություններ

• 2xx պատասխան 10 վայրկյանի ընթացքում՝ հաղորդագրությունը առաքված է։ Ցանկացած այլ պատասխան կամ դրա բացակայություն՝ սխալ։
• Սխալից հետո փորձը կրկնվում է 1 րոպե, 5 րոպե, 30 րոպե, 2 ժամ, 6 ժամ և մեկ օր անց՝ ընդամենը յոթ փորձ։
• Եթե հասցեն երեք օր չի ընդունում հաղորդագրություններ, այն անջատվում է, իսկ օբյեկտի մոդերատորներին ծանուցում է գալիս։
• Առաքումների մատյանը 30 օրվա համար՝ հաղորդագրության մարմնով և ստացողի պատասխանով, բացվում է վեբհուքի էջում. այնտեղ են նաև «Ստուգել» և «Կրկնել հիմա» կոճակները։

Bitrix24

Միացվում է օբյեկտի կարգավորումների «Ինտեգրացիաներ» ներդիրում՝ պորտալի մուտքային վեբհուքի հասցե և ընտրություն՝ լիդ, թե գործարք։ Այնուհետև Dvorum ծառայությունն ինքն է կանչում պորտալի REST API-ն։

• Նոր հայտ՝ լիդ կամ գործարք․ վերնագիր, տարածք, գոտի, թեմա և հայտի քարտի հղում։
• Հայտի կարգավիճակի փոփոխություն՝ մեկնաբանություն նույն գրառման ժապավենում։
• «Ստուգել» կոճակը ցույց է տալիս՝ արդյոք պորտալը կապի մեջ է և արդյոք վեբհուքն ունի CRM իրավունք։

Ինչպես վեբհուքում, գրառման մեջ անուններ, հեռախոսահամարներ և էլ. փոստ չկան։ Մնացած իրադարձությունները՝ վճարումներ, անցագրեր, վարձակալներ, Bitrix24-ն ընդունում է սովորական վեբհուքի միջոցով։

amoCRM

Միացվում է օբյեկտի կարգավորումների «Ինտեգրացիաներ» ներդիրում՝ հաշվի հասցե, մասնավոր ինտեգրացիայի երկարաժամկետ թոքեն և փուլ, որտեղ հայտնվում է նոր գործարքը։ Այնուհետև Dvorum ծառայությունն ինքն է կանչում հաշվի API-ն։

• Նոր հայտ՝ գործարք ընտրված փուլում նշումով․ տարածք, գոտի, թեմա և հայտի քարտի հղում։
• Հայտի կարգավիճակի փոփոխություն՝ նշում նույն գործարքին։
• Գործարքի փուլը կարող է փոխել հայտի կարգավիճակը․ փուլի փոփոխություններին բաժանորդագրվում են կարգավորումների կոճակով, իսկ փուլերը համապատասխանեցվում են կարգավիճակներին։
• «Ստուգել» կոճակը ցույց է տալիս՝ արդյոք թոքենը գործում է և արդյոք ընտրված փուլը դեռ կա։

Ինչպես վեբհուքում, գործարքում անուններ, հեռախոսահամարներ և էլ. փոստ չկան։