{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://api13.arm20.com/v1/schemas/nakl.tax_save_contrag.json","title":"nakl.tax_save_contrag","description":"Зберігає реквізити контрагента для податкової накладної.","type":"object","required":["request","response"],"additionalProperties":false,"properties":{"request":{"oneOf":[{"type":"object","required":["method","params"],"additionalProperties":false,"properties":{"method":{"const":"nakl.tax_save_contrag"},"params":{"type":"object","additionalProperties":false,"properties":{"branch":{"type":"string","maxLength":4096,"default":"","title":"Філія","example":"","description":"Поле «Філія» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"ipn":{"type":"string","maxLength":4096,"default":"","title":"ІПН","example":"","description":"Поле «ІПН» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"jdata_hex":{"type":"string","maxLength":60000,"default":"","title":"JSON-дані у HEX","example":"","description":"Поле «JSON-дані у HEX» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"okpo":{"type":"string","maxLength":4096,"default":"","title":"ЄДРПОУ","example":"","description":"Поле «ЄДРПОУ» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"sign_name":{"type":"string","maxLength":512,"default":"","title":"ПІБ підписанта","example":"","description":"Поле «ПІБ підписанта» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"sign_tax_num":{"type":"string","maxLength":4096,"default":"","title":"Податковий номер підписанта","example":"","description":"Поле «Податковий номер підписанта» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Фіскалізація"},"source_nn":{"type":"string","maxLength":512,"minLength":1,"title":"Номер документа-джерела","example":"ПН-1001","description":"Поле «Номер документа-джерела» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"tax_code":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":1,"title":"Податковий код","example":1,"description":"Поле «Податковий код» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Фіскалізація"},"tax_num":{"type":"string","maxLength":4096,"default":"","title":"Податковий номер","example":"","description":"Поле «Податковий номер» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Фіскалізація"}},"required":["source_nn"]},"id":{"type":["string","integer","null"]}}}]},"response":{"oneOf":[{"type":"object","required":["ok","data","request_id"],"additionalProperties":false,"properties":{"ok":{"const":true},"data":{"type":"object","required":["method","result","id"],"additionalProperties":false,"properties":{"method":{"const":"nakl.tax_save_contrag"},"result":{"type":"object","required":["upstream","status","rows"],"additionalProperties":false,"properties":{"upstream":{"type":"object","required":["name","version","resource"],"additionalProperties":false,"properties":{"name":{"const":"UPMAPI"},"version":{"type":"string"},"resource":{"type":"string"}}},"status":{"type":"object","required":["code","operation","affected","detail"],"additionalProperties":false,"properties":{"code":{"const":"OK"},"operation":{"type":"string"},"affected":{"type":"string","title":"Змінено записів","description":"Кількість записів, які upstream фактично змінив.","example":"Приклад"},"detail":{"type":"string","title":"Деталі результату","description":"Безпечні додаткові відомості про виконання операції.","example":"Приклад"}}},"rows":{"type":"array","items":{},"maxItems":0}}},"id":{"type":["string","integer","null"]}}},"request_id":{"type":"string"}}}]}},"x-api13-operation":{"description":"Зберігає реквізити контрагента для податкової накладної.","scope":"inventory.write","params":{"branch":{"type":"string","max":4096,"default":"","title":"Філія","description":"Поле «Філія» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":""},"ipn":{"type":"string","max":4096,"default":"","title":"ІПН","description":"Поле «ІПН» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":""},"jdata_hex":{"type":"string","max":60000,"default":"","title":"JSON-дані у HEX","description":"Поле «JSON-дані у HEX» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":""},"okpo":{"type":"string","max":4096,"default":"","title":"ЄДРПОУ","description":"Поле «ЄДРПОУ» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":""},"sign_name":{"type":"string","max":512,"default":"","title":"ПІБ підписанта","description":"Поле «ПІБ підписанта» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":""},"sign_tax_num":{"type":"string","max":4096,"default":"","title":"Податковий номер підписанта","description":"Поле «Податковий номер підписанта» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Фіскалізація","example":""},"source_nn":{"type":"string","max":512,"required":true,"title":"Номер документа-джерела","description":"Поле «Номер документа-джерела» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":"ПН-1001"},"tax_code":{"type":"int","min":-2147483648,"max":2147483647,"default":1,"title":"Податковий код","description":"Поле «Податковий код» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Фіскалізація","example":1},"tax_num":{"type":"string","max":4096,"default":"","title":"Податковий номер","description":"Поле «Податковий номер» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Фіскалізація","example":""}},"result":{"mode":"status","fields":["affected","detail"],"field_specs":{"affected":{"title":"Змінено записів","description":"Кількість записів, які upstream фактично змінив.","type":"string","example":"Приклад"},"detail":{"title":"Деталі результату","description":"Безпечні додаткові відомості про виконання операції.","type":"string","example":"Приклад"}}},"mutating":true,"idempotency_required":true,"since":"0.4.0","stability":"stable","deprecated":false,"aliases":["nakl","tax save contrag","Зберігає реквізити контрагента для податкової накладної.","накладна","документ складу"],"errors":[{"code":"INVALID_PARAMETER","http":422,"description":"Один із параметрів має неправильний тип, формат або значення.","retry":"Виправити запит; автоматично не повторювати."},{"code":"UPSTREAM_FAILURE","http":502,"description":"Сервер бізнес-операції недоступний або відхилив безпечний контракт.","retry":"Не створювати новий Idempotency-Key; перевірити журнал і бізнес-об’єкт."},{"code":"IDEMPOTENCY_KEY_REQUIRED","http":422,"description":"Для виконання запису не передано Idempotency-Key.","retry":"Створити ключ для цієї бізнес-операції та повторити."},{"code":"IDEMPOTENCY_RESULT_UNKNOWN","http":409,"description":"Результат попередньої спроби невідомий; gateway не виконав запис повторно.","retry":"Звірити документ, чек або платіж; не створювати новий ключ автоматично."}],"related_methods":["nakl.tax_contrag_index","nakl.tax_save_invoice","nakl.tax_saved_contrag","nakl.tax_saved_invoice"]}}