bfocus 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3daefe09e7aa1fed098c71ffdbc8f0b43c020519b72031355aac21a8b16011ed
-  data.tar.gz: a21b02db9aff17837cf93cc6063b16324e4593382543fa7c1c0eedd032d916a9
+  metadata.gz: 7f93ce899d6f0b828abbb48251c0b2899e21203806e65ca1596c69494eaf89db
+  data.tar.gz: 75d630e82fce06c4fdfb1ba296bd08793387de045e8eb9ca3a0ba82c96bacbc9
 SHA512:
-  metadata.gz: 111b5a2790952c3ba34c11d7d7f8d101b620b3e44b1869730d6663daf97a2f28c27880febb48aca95e3112f41e9159ba5c2174986d7242ad4b242f9ab8ff15c0
-  data.tar.gz: 8a8ee123b356b52e8c8fbfeded349d168bdad83c39a010e3328b7635a0424e13f5413295e2c991e4a9a82fe3444c3200cc0fbbe471c82132468a548ac02c0e02
+  metadata.gz: 535a2dc1a6212586ad0e2132598f4f941fb1dfd038d9f177c0e653cbc45aed3b1032f275debfaafd1fc7ccf26f5ae8261e7fdbf802014c5662b57a8b7f21f9d9
+  data.tar.gz: d364b663c8a226ae81c7ec76215bb83314d48c9959097c886a6b87afca55792f45502033a6c813d803c3c10b39886c6041a2a726eb2eee4779d96d51830ab7b4

data/README.md

@@ -190,7 +190,10 @@ client.people.upsert("erp-1042", "app-77", access: true) # devolve o acesso
 
 - **Nunca duplica.** O e-mail (ou o telefone) acha a pessoa que já chegou por e-mail, pelo widget
   ou por outro sistema, e ela é **adotada** (ganha o seu `external_id`).
-- A mesma pessoa enviada com **outro cliente** é **transferida** para ele.
+- A mesma pessoa enviada com **outro cliente** NÃO é transferida: fica **ligada** também a ele
+  (`"linked" => true` na resposta). O cadastro é único e a mesma pessoa circula por vários clientes.
+- **O acesso é do vínculo.** `delete` (e `access: false`) tira o acesso dela NESTE cliente, não nos
+  outros: `"unlinked" => true` na resposta quer dizer que ela segue ativa em algum outro.
 - Como no resto da SDK, só o que você passa muda; `nil` limpa (`phone: nil`).
 - Campos: `name`, `email`, `phone`, `role`, `access` (pode usar o atendimento), `is_primary`
   (contato principal), `extra_emails`, `extra_phones`, `custom_fields`, `clear`.

data/lib/bfocus/resources/customers.rb

@@ -158,12 +158,21 @@ module Bfocus
       #
       # Só os campos informados mudam; `nil` limpa. `custom_fields` (lista de
       # `{key:, label:, type:, value:, options:}`), quando enviado, **substitui** a lista inteira.
+      #
+      # `kind` é o tipo do CONTRATANTE: `"pj"` (empresa) ou `"pf"` (pessoa física). Não enviando,
+      # o bFocus deduz do documento. `legal_name` (razão social), `state_registration` e
+      # `municipal_registration` são de PJ; `id_document` (RG), de PF.
       # @return [Hash] o cliente.
-      def upsert(external_id, name: UNSET, document: UNSET, email: UNSET, phone: UNSET,
+      def upsert(external_id, name: UNSET, document: UNSET, kind: UNSET, legal_name: UNSET,
+                 state_registration: UNSET, municipal_registration: UNSET, id_document: UNSET,
+                 email: UNSET, phone: UNSET,
                  website: UNSET, notes: UNSET, custom_fields: UNSET, idempotency_key: nil, timeout: nil)
         ext = segment(external_id, "external_id")
         body = compact(
-          "name" => name, "document" => document, "email" => email, "phone" => phone,
+          "name" => name, "document" => document, "kind" => kind, "legal_name" => legal_name,
+          "state_registration" => state_registration,
+          "municipal_registration" => municipal_registration, "id_document" => id_document,
+          "email" => email, "phone" => phone,
           "website" => website, "notes" => notes, "custom_fields" => custom_fields
         )
         call("PUT", "/customers/#{ext}", body: body, idempotency_key: idempotency_key, timeout: timeout)

data/lib/bfocus/resources/people.rb

@@ -69,8 +69,9 @@ module Bfocus
       # `PUT /customers/{customer_external_id}/people/{person_external_id}`
       #
       # Só o que vier muda; `nil` limpa. O e-mail (ou telefone) acha a pessoa que já chegou por
-      # outro caminho e ela é adotada, nunca duplicada; se ela estava em outro cliente, é
-      # transferida. `access: true` devolve o acesso retirado por {#delete}.
+      # outro caminho e ela é adotada, nunca duplicada. Se ela já existia em OUTRO cliente, NÃO é
+      # transferida: fica ligada também a este (cadastro único, `"linked" => true` na resposta).
+      # `access: true` devolve o acesso retirado por {#delete}.
       #
       # @param access [Boolean] pode abrir chamados/usar o widget.
       # @param is_primary [Boolean] contato principal do cliente.
@@ -88,7 +89,9 @@ module Bfocus
       #   PRÓPRIA ficha: alcançando a pessoa por um identificador EXTRA, a API recusa (409
       #   `PERSON_CLEAR_NOT_OWN_RECORD`) — apagar contato de ficha alcançada por apelido seria
       #   apagar dado de outro sistema.
-      # @return [Hash] a pessoa + `"status"`.
+      # @return [Hash] a pessoa + `"status"`, `"linked"` (já existia em outro cliente e agora está
+      #   ligada a este também) e `"merged_into"` (o id que você mandou era um apelido; este é o
+      #   principal do cadastro).
       def upsert(customer_external_id, person_external_id, name: UNSET, email: UNSET, phone: UNSET,
                  role: UNSET, access: UNSET, is_primary: UNSET, extra_emails: UNSET, extra_phones: UNSET,
                  custom_fields: UNSET, clear: UNSET, idempotency_key: nil, timeout: nil)
@@ -110,9 +113,13 @@ module Bfocus
              timeout: timeout)
       end
 
-      # Retira o acesso da pessoa (ela continua no histórico).
+      # Retira o acesso da pessoa NESTE cliente (ela continua no histórico).
       # `DELETE /customers/{customer_external_id}/people/{person_external_id}`
-      # @return [Hash] a pessoa, com `"access" => false`.
+      #
+      # O acesso é DO VÍNCULO: a mesma pessoa circula por vários clientes e tirar o acesso aqui
+      # não tira o dela nos outros.
+      # @return [Hash] a pessoa, com `"access" => false` e `"unlinked"` (`true` = ela segue ativa
+      #   em outros clientes; `false` = era só deste e foi desligada).
       def delete(customer_external_id, person_external_id, idempotency_key: nil, timeout: nil)
         cid = segment(customer_external_id, "customer_external_id")
         pid = segment(person_external_id, "person_external_id")

data/lib/bfocus/version.rb

@@ -3,5 +3,5 @@
 module Bfocus
   # Versão da gem. O `scripts/release-sdks.sh` do monorepo bumpa esta linha por regex e o
   # `bfocus.gemspec` lê daqui — mantenha o formato exato `VERSION = "X.Y.Z"`.
-  VERSION = "0.2.1"
+  VERSION = "0.2.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bfocus
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: ruby
 authors:
 - Berni Software