pub struct ArchiveClient { /* private fields */ }Expand description
Client for the Yuki Archive SOAP service.
Implementations§
Source§impl ArchiveClient
impl ArchiveClient
pub fn new() -> Self
Sourcepub async fn authenticate(&mut self, api_key: &str) -> Result<String, YukiError>
pub async fn authenticate(&mut self, api_key: &str) -> Result<String, YukiError>
Authenticate with the Yuki API and store the session ID.
Sourcepub async fn documents_in_folder(
&self,
folder_id: i32,
start_date: &str,
end_date: &str,
) -> Result<Vec<ArchiveDocument>, YukiError>
pub async fn documents_in_folder( &self, folder_id: i32, start_date: &str, end_date: &str, ) -> Result<Vec<ArchiveDocument>, YukiError>
List all documents in an archive folder by folder ID.
Sourcepub async fn documents_by_type(
&self,
doc_type: i32,
) -> Result<String, YukiError>
pub async fn documents_by_type( &self, doc_type: i32, ) -> Result<String, YukiError>
List all documents of a given document type.
Sourcepub async fn search_documents(
&self,
search_text: &str,
start_date: &str,
end_date: &str,
) -> Result<Vec<ArchiveDocument>, YukiError>
pub async fn search_documents( &self, search_text: &str, start_date: &str, end_date: &str, ) -> Result<Vec<ArchiveDocument>, YukiError>
Search documents in the archive using a free-text query within a date range.
Pass an empty string for search_text to retrieve all documents in the period.
Returns up to 500 results sorted by document date descending.
Sourcepub async fn modified_documents_by_type(
&self,
doc_type: i32,
modified_since: &str,
) -> Result<String, YukiError>
pub async fn modified_documents_by_type( &self, doc_type: i32, modified_since: &str, ) -> Result<String, YukiError>
List documents of a given type that were modified since the specified date.
Sourcepub async fn upload_document(
&self,
admin_id: &str,
filename: &str,
data_base64: &str,
folder_id: i32,
) -> Result<String, YukiError>
pub async fn upload_document( &self, admin_id: &str, filename: &str, data_base64: &str, folder_id: i32, ) -> Result<String, YukiError>
Upload a document to the archive without additional metadata.
Returns the document ID assigned by Yuki.
Sourcepub async fn upload_document_with_data(
&self,
admin_id: &str,
filename: &str,
data_base64: &str,
folder_id: i32,
currency: &str,
amount: f64,
cost_category: Option<&str>,
payment_method: Option<&str>,
project: Option<&str>,
remarks: Option<&str>,
) -> Result<String, YukiError>
pub async fn upload_document_with_data( &self, admin_id: &str, filename: &str, data_base64: &str, folder_id: i32, currency: &str, amount: f64, cost_category: Option<&str>, payment_method: Option<&str>, project: Option<&str>, remarks: Option<&str>, ) -> Result<String, YukiError>
Upload a document to the archive with invoice metadata.
Returns the document ID assigned by Yuki.
Sourcepub async fn cost_categories(&self) -> Result<Vec<CostCategory>, YukiError>
pub async fn cost_categories(&self) -> Result<Vec<CostCategory>, YukiError>
Retrieve all available cost categories.
Sourcepub async fn payment_methods(&self) -> Result<Vec<PaymentMethod>, YukiError>
pub async fn payment_methods(&self) -> Result<Vec<PaymentMethod>, YukiError>
Retrieve all available payment methods.
Sourcepub fn parse_archive_documents(
xml: &str,
) -> Result<Vec<ArchiveDocument>, YukiError>
pub fn parse_archive_documents( xml: &str, ) -> Result<Vec<ArchiveDocument>, YukiError>
Parse a SearchDocuments or DocumentsInFolder SOAP response into a list of documents.
Each <Document ID="uuid"> element carries child elements for each field.
The document ID is an XML attribute; all other fields are child text nodes.
Sourcepub fn parse_cost_categories(xml: &str) -> Result<Vec<CostCategory>, YukiError>
pub fn parse_cost_categories(xml: &str) -> Result<Vec<CostCategory>, YukiError>
Parse a CostCategories SOAP response.
Each CostCategory element carries an ID attribute and a Description child element:
<CostCategory ID="45100"><Description>...</Description></CostCategory>
Sourcepub fn parse_payment_methods(xml: &str) -> Result<Vec<PaymentMethod>, YukiError>
pub fn parse_payment_methods(xml: &str) -> Result<Vec<PaymentMethod>, YukiError>
Parse a PaymentMethods SOAP response.
Each PaymentMethod element carries an ID attribute and a Description child element:
<PaymentMethod ID="4"><Description>...</Description></PaymentMethod>