Получение списка банковских счетов

Получение банковских счетов реализовано через HTTP-сервис API Бухгалтерии (ExternalAPI). Данный механизм позволяет получать актуальные данные банковских счетов организаций. Механизм является синхронным и возвращает результат по рассчитанным данным сразу при обращении.

Запрос

GET {{baseURL}}/bank_accounts/
Authorization: {{api_authorization}}

 Запрос выполняется от имени служебного пользователя обслуживающей организации.

Поля ответа:

  • organizations  – данные по организациям
    • organization  – организация
      • inn  – ИНН организации
      • kpp – КПП организации
      • name  – представление организации
    • bank _ accounts   – данные банковских счетов
      • bank   – БИК банка
      • account – номер счета
      • opening_ date – дата открытия счета в формате ISO
      • closing_ date   – дата закрытия счета в формате ISO

Пример запроса

https://1cfresh.com/a/bs/10420/hs/api/v1/bank_accounts/

 Пример ответа

{  
  "organizations":[  
    {  
      "organization":{  
        "inn":"500110126803",
        "kpp":"",
        "name":"ИП Роозилилль К. У."
      },
      "bank_accounts":[  
        {  
          "bank":"044525555",
          "account":"40802810000000011662",
          "opening_date":"2017-01-01T00:00:00",
          "closing_date":""
        },
        {  
          "bank":"044525555",
          "account":"40802810000000011659",
          "opening_date":"2015-01-01T00:00:00",
          "closing_date":"2018-12-31T00:00:00"
        },
        {  
          "bank":"044525999",
          "account":"40802810703270000340",
          "opening_date":"",
          "closing_date":""
        }
      ]
    }
  ]
}

Изменение / добавление банковских счетов

Добавление (обновление) данных в 1С производится с помощью метода post механизма интеграции объектов.

Данные отправляются  в zip-архиве, в составе которого содержится файл manifest.json.

Состав данных bank_accounts.zip практически аналогичен  base_ data. zip :

Состав манифеста (manifest.json)

{  
  "upload":[  
    {  
      "file":"bank_accounts.json",
      "handler":"bank_accounts",
      "version":"83B92338"
    },
    {  
      "file":"kl_to_1c.txt",
      "handler":"initial_balances_bank_account_statement"
    },
    {  
      "file":"kl_to_1c.txt",
      "handler":"bank_account_statement_1c_txt"
    }
  ]
}

Т.е. в одном post можно добавить новый счет(а), инициировать заполнение остатков по нему и загрузить выписку. В реальной работе так делать не рекомендуется, нужно посылать каждый headler отдельно. Обработка нескольких headler в асинхронном режиме происходит параллельно, это может привести к тому, что выписка будет загружаться по счету, который еще не добавлен – в этом случае загрузка выписки завершиться ошибкой.

Данные по счетам (bank_ accounts. json)

Состав файла bank_ accounts. json похож на base_ data. json. Данные по организации (предпринимателю) нужны только для отбора и могут не указываться. Если указываются, то требуется только ИНН (для ИП) или ИНН + КПП (для организации).

При обработке данные организации не изменяются, меняются только данные банковских счетов этой организации.

{  
  "entrepreneur":{  
    "inn":"500110126803"
  },
  "bank_accounts":[  
    {  
      "bank":"044525555",
      "account":"40802810000000011662",
      "opening_date":"2017-01-01T00:00:00"
    },
    {  
      "bank":"044525555",
      "account":"40802810000000011659",
      "opening_date":"2015-01-01T00:00:00",
      "closing_date":"2018-31-12T00:00:00"
    },
    {  
      "bank":"044525999",
      "account":"40802810703270000340"
    }
  ]
}