{"id":14983560,"url":"https://github.com/henrybravos/micro_report_ecocont","last_synced_at":"2026-01-05T08:04:02.830Z","repository":{"id":254156973,"uuid":"845702991","full_name":"henrybravos/micro_report_ecocont","owner":"henrybravos","description":"microservice  report for ecocont","archived":false,"fork":false,"pushed_at":"2024-09-17T18:13:18.000Z","size":174,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-03T06:34:24.033Z","etag":null,"topics":["connect","excel","golang","golangci-lint","grpc","grpc-go","microservice","pdf","protobuf"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/henrybravos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-21T19:03:01.000Z","updated_at":"2024-09-17T19:11:27.000Z","dependencies_parsed_at":"2024-08-21T19:35:21.804Z","dependency_job_id":"b4d3c91e-9f75-42d2-83e0-6b459584e167","html_url":"https://github.com/henrybravos/micro_report_ecocont","commit_stats":{"total_commits":44,"total_committers":2,"mean_commits":22.0,"dds":"0.022727272727272707","last_synced_commit":"b0f2de46050867427df38c5b882df99a72bc15c8"},"previous_names":["henrybravos/micro_report","henrybravos/micro_report_ecocont"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henrybravos%2Fmicro_report_ecocont","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henrybravos%2Fmicro_report_ecocont/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henrybravos%2Fmicro_report_ecocont/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henrybravos%2Fmicro_report_ecocont/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/henrybravos","download_url":"https://codeload.github.com/henrybravos/micro_report_ecocont/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239362372,"owners_count":19626117,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["connect","excel","golang","golangci-lint","grpc","grpc-go","microservice","pdf","protobuf"],"created_at":"2024-09-24T14:07:26.282Z","updated_at":"2025-11-02T02:30:40.349Z","avatar_url":"https://github.com/henrybravos.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Installation\n\nInstall micro-report with tidy\n\n```bash\n  go mod tidy\n  create .env file\n  put the fonts in the root/fonts\n      root/fonts\n      - ARIAL.TTF //normal\n      - ARIALBD.TTF //BOLD\n  \n  make directories\n        root/tmp\n        root/tmp/pdf\n        root/tmp/excel\n  \n  go run cmd/server/main.go\n```\n## Connect GRPC\n### Requeriments\n- Install [buf](https://docs.buf.build/installation)\n\n### Generate pb\n\n```bash\n  cd protos\n  buf lint\n  buf generate\n```\n\n## API Reference\n\n### Sales\n\n#### Get pdf/excel sales report\n\n```http\n  POST /v1.SalesService/RetrieveSalesResourceReport\n```\n\n| Parameter    | Type     | Description                                                                |\n|:-------------|:---------|:---------------------------------------------------------------------------|\n| `period`     | `string` | **Required**. Period for retrieve, eg: 2024-01                             |\n| `businessId` | `string` | **Required**. Company for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef |\n| `type`       | `number` | **Required**. 1 PDF, 2 XLSX                                                |\n\n**return:** `string` path of file, use: http://localhost:8080/tmp/pdf/2024000.pdf\navailable for 5 minutes\n\n#### Get sales report paginated\n\n```http\n  POST /v1.SalesService/RetrieveSalesPaginatedReport\n```\n\n| Parameter    | Type     | Description                                                                |\n|:-------------|:---------|:---------------------------------------------------------------------------|\n| `period`     | `string` | **Required**. Period for retrieve, eg: 2024-01                             |\n| `businessId` | `string` | **Required**. Company for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef |\n| `page`       | `int`    | **Required**. Page number, eg: 1162                                        |\n| `pageSize`   | `int`    | **Required**. Page size, eg: 30                                            |\n\n**return:** []SalesReport\n\n### Journal \"Libro de trabajo\"\n\n```http\n  POST /v1.JournalService/RetrieveJournalReport\n```\n\n| Parameter                | Type     | Description                                                                |\n|:-------------------------|:---------|:---------------------------------------------------------------------------|\n| `period`                 | `string` | **Required**. Period for retrieve, eg: 2024-01                             |\n| `businessId`             | `string` | **Required**. Company for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef |\n| `isConsolidated`         | `bool`   | is consolidated, DEFAULT: false                                            |\n| `includeCuBa`            | `bool`   | include accounts bank, DEFAULT: false                                      |\n| `includeClose`           | `bool`   | include close report, DEFAULT: false                                       |\n\n**return:** proto []JournalEntries\n\n### Balance Cash  \"Libro caja\"\n\n```http\n  POST /v1.CashBookService/RetrieveCashBook\n```\n\n| Parameter              | Type       | Description                                                                |\n|:-----------------------|:-----------|:---------------------------------------------------------------------------|\n| `period`               | `string`   | **Required**. Period for retrieve, eg: 2024-01                             |\n| `businessId`           | `string`   | **Required**. Company for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef |\n| `accountIds`           | `[]string` | **Required**. financial accounts list, eg [\"ID\"]                           |\n\n**return:** proto []CashBook and []AccountBalance\n\n### Bank Book \"Libro bancos\"\n\n```http\n  POST /v1.BankBookService/RetrieveBankBook\n```\n\n| Parameter              | Type       | Description                                                                |\n|:-----------------------|:-----------|:---------------------------------------------------------------------------|\n| `period`               | `string`   | **Required**. Period for retrieve, eg: 2024-01                             |\n| `businessId`           | `string`   | **Required**. Company for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef |\n| `accountIds`           | `[]string` | **Required**. financial accounts list, eg [\"ID\"]                           |\n\n**return:** proto []BalanceBank and []LBanks\n\n\n### Balance Diario \"Libro diario\"\n\n```http\n  POST /v1.JournalService/RetrieveGeneralJournal\n```\n\n| Parameter              | Type       | Description                                                                |\n|:-----------------------|:-----------|:---------------------------------------------------------------------------|\n| `period`               | `string`   | **Required**. Period for retrieve, eg: 2024-01                             |\n| `businessId`           | `string`   | **Required**. Company for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef |\n| `isConsolidated`       | `bool`     | is consolidated, DEFAULT: false                                            |\n| `includeCuBa`          | `bool`     | include accounts bank, DEFAULT: false                                      |\n| `includeClose`         | `bool`     | include close report, DEFAULT: false                                       |\n\n**return:** proto []GeneralJournal\n\n### \"Kardex Valorizado\"\n    \n```http\n    POST /v1.KardexService/RetrieveKardexValued\n```\n\n| Parameter      | Type          | Description                                                                       |\n|:---------------|:--------------|:----------------------------------------------------------------------------------|\n| `localId`      | `string`      | **Required**. Local Company for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef  |\n| `includeNotes` | `bool`        | **Required**. internal Notes, Default FALSE,                                      |\n| `period`       | `string,null` | Retrieve per Period, eg: 2024-01                                                  |\n| `productId`    | `string,null` | Product for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef                      |\n| `startDate`    | `string,null` | Date to search data.  To retrieve data between dates, period must be NULL         |\n| `endDate`      | `string,null` | Date to search data.  To retrieve data between dates, period must be NULL         |\n\n**return:** proto []KardexValued\n\n### \"Registro de compras\"\n\n```http\n    POST /v1.PurchaseService/RetrievePurchaseReport\n```\n\n| Parameter    | Type         | Description                                                                |\n|:-------------|:-------------|:---------------------------------------------------------------------------|\n| `businessId` | `string`     | **Required**. Company for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef |\n| `period`     | `string`     | **Required**. Retrieve per Period, eg: 2024-01                             |\n\n**return:** proto []PurchaseReport\n\n### \"Libro Mayor\"\n    \n```http\n    POST /v1.JournalService/RetrieveMajorBook\n```\n| Parameter          | Type       | Description                                                                    |\n|:-------------------|:-----------|:-------------------------------------------------------------------------------|\n| `period`           | `string`   | **Required**. Period for retrieve, eg: 2024-01                                 |\n| `businessId`       | `string`   | **Required**. Company for filter, eg: bf4336e4-b9b7-11ec-b4c3-00505605deef     |\n| `isConsolidated`   | `bool`     | is consolidated, DEFAULT: false                                                |\n| `includeCuBa`      | `bool`     | include accounts bank, DEFAULT: false                                          |\n| `includeClose`     | `bool`     | include close report, DEFAULT: false                                           |\n| `lfType`           | `bool`     | include close report, DEFAULT: '', eg: 060100                                  |\n\n**return:** proto []MajorBook\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhenrybravos%2Fmicro_report_ecocont","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhenrybravos%2Fmicro_report_ecocont","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhenrybravos%2Fmicro_report_ecocont/lists"}