{"_rev":"4-288ec555afa439d308e6ed305fb228ff","time":{"created":"2025-07-14T18:05:43.708Z","modified":"2025-07-14T18:05:44.432Z","0.1.0":"2025-07-14T17:30:44.468Z","0.1.1":"2025-07-14T18:05:44.028Z"},"_id":"@angga-ada-ai/n8n-nodes-biteship","name":"@angga-ada-ai/n8n-nodes-biteship","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@angga-ada-ai/n8n-nodes-biteship","version":"0.1.1","description":"n8n nodes for Biteship API integration","keywords":["n8n-community","biteship","logistics","automation"],"license":"MIT","author":{"name":"Your Name"},"repository":{"type":"git","url":"git+https://github.com/adaAI-apps/n8n-nodes-biteship.git"},"main":"index.js","scripts":{"build":"tsc && gulp build:package","lint":"eslint . --ext .ts","watch":"tsc --watch"},"n8n":{"n8nNodesApiVersion":1,"nodes":["./dist/nodes/BiteshipCouriers/BiteshipCouriers.node.js","./dist/nodes/BiteshipDraftOrders/BiteshipDraftOrders.node.js","./dist/nodes/BiteshipLocations/BiteshipLocations.node.js","./dist/nodes/BiteshipMaps/BiteshipMaps.node.js","./dist/nodes/BiteshipOrders/BiteshipOrders.node.js","./dist/nodes/BiteshipRates/BiteshipRates.node.js","./dist/nodes/BiteshipTracking/BiteshipTracking.node.js"],"credentials":["./dist/credentials/BiteshipApi.credentials.js"]},"devDependencies":{"@types/express":"^4.17.17","@types/request-promise-native":"^1.0.18","gulp":"^4.0.2","n8n-workflow":"*","typescript":"~4.9.5","@typescript-eslint/parser":"^5.62.0","@typescript-eslint/eslint-plugin":"^5.62.0","eslint":"^8.57.0"},"peerDependencies":{"n8n-workflow":"*"},"_id":"@angga-ada-ai/n8n-nodes-biteship@0.1.1","gitHead":"3ec2dc445cd9af4ae80fbb3af8f948f616f80a68","bugs":{"url":"https://github.com/adaAI-apps/n8n-nodes-biteship/issues"},"homepage":"https://github.com/adaAI-apps/n8n-nodes-biteship#readme","_nodeVersion":"22.16.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-pQSHqARMo5YYty+6drBCXUqg4ZVWT1o4g6Iv9FAreZIVjxHzjXvbLZplkHD0ZmQS24SgiSL8DgA7ICsklpj4ww==","shasum":"9d34082bdf651994599b6f3d26273c1c1b18ab92","tarball":"https://registry.npmjs.org/@angga-ada-ai/n8n-nodes-biteship/-/n8n-nodes-biteship-0.1.1.tgz","fileCount":44,"unpackedSize":344794,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDEILYEB6n8HLhq5ioNUMAgf8SfbycadYriG58RBFfRpgIhANhE3xBteHTIk4dlWHsKrk81v05gqa//kuDVnIQBLMEf"}]},"_npmUser":{"name":"angga-ada-ai","email":"angga.riyansyah@gmail.com"},"directories":{},"maintainers":[{"name":"angga-ada-ai","email":"angga.riyansyah@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-biteship_0.1.1_1752516343839_0.12979367731195435"},"_hasShrinkwrap":false}},"maintainers":[{"name":"angga-ada-ai","email":"angga.riyansyah@gmail.com"}],"description":"n8n nodes for Biteship API integration","homepage":"https://github.com/adaAI-apps/n8n-nodes-biteship#readme","keywords":["n8n-community","biteship","logistics","automation"],"repository":{"type":"git","url":"git+https://github.com/adaAI-apps/n8n-nodes-biteship.git"},"author":{"name":"Your Name"},"bugs":{"url":"https://github.com/adaAI-apps/n8n-nodes-biteship/issues"},"license":"MIT","readme":"# n8n-nodes-biteship\n\nThis is an n8n community node. It lets you use Biteship in your n8n workflows.\n\nBiteship is Indonesia's leading shipping and logistics platform that connects businesses with multiple courier services including JNE, SiCepat, Grab, Gojek, and many others.\n\n[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.\n\n[Installation](#installation)  \n[Operations](#operations)  \n[Credentials](#credentials)  \n[Compatibility](#compatibility)  \n[Usage](#usage)  \n[Resources](#resources)  \n\n## Installation\n\nFollow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.\n\n## Operations\n\n### Rates\n- **Get Rates**: Calculate shipping rates from multiple couriers based on origin/destination (supports postal codes, coordinates, or area IDs)\n\n### Orders\n- **Create**: Create a new shipping order\n- **Get**: Retrieve order details by ID\n- **Cancel**: Cancel an existing order\n\n### Draft Orders\n- **Create**: Create a draft order for rate comparison\n- **Get**: Retrieve draft order details\n- **Update**: Update draft order information (courier, location, items)\n- **Delete**: Delete a draft order\n- **Confirm**: Convert draft order to actual order\n- **Get Rates**: Get available shipping rates for a draft order\n\n### Tracking\n- **Track by Order ID**: Track shipment using Biteship order ID\n- **Track by Waybill**: Track shipment using waybill ID and courier code\n\n### Couriers\n- **Get All**: Retrieve list of available courier services\n\n### Locations\n- **Create**: Create a saved shipping location\n- **Get**: Retrieve location details by ID\n- **Update**: Update location information\n- **Delete**: Delete a saved location\n\n### Maps\n- **Search Areas**: Search for areas, cities, or districts by name\n\n## Credentials\n\nTo use this node, you need a Biteship API key:\n\n1. Sign up for a [Biteship account](https://biteship.com/)\n2. Go to your dashboard and navigate to API settings\n3. Generate an API key\n4. In n8n, create new Biteship API credentials\n5. Enter your API key\n6. Select environment (Test/Production)\n\n**Note**: Use test environment for development and testing. Production environment will create actual shipments and charges.\n\n## Compatibility\n\n- Minimum n8n version: 0.198.0\n- Tested with n8n versions: 0.198.0+\n\n## Usage\n\n### Basic Rate Calculation\n\n1. Add Biteship node to your workflow\n2. Select \"Rates\" resource and \"Get Rates\" operation\n3. Choose location type (Postal Code, Coordinates, or Area ID)\n4. Fill in origin and destination details\n5. Add items with dimensions and weight\n6. Specify courier codes (comma-separated, e.g., \"jne,sicepat,grab\")\n7. Execute to get shipping rates\n\n### Creating an Order\n\n1. Select \"Orders\" resource and \"Create\" operation\n2. Fill in origin and destination contact details\n3. Choose location type and provide location data\n4. Add items to ship\n5. Set delivery type (now/schedule)\n6. Optionally add courier preferences, insurance, or COD\n7. Execute to create the order\n\n### Tracking a Shipment\n\n1. Select \"Tracking\" resource\n2. Choose \"Track by Order ID\" for Biteship orders or \"Track by Waybill\" for external tracking\n3. Provide the order ID or waybill ID + courier code\n4. Execute to get tracking information and history\n\n### Working with Draft Orders\n\nDraft orders are useful for comparing rates before committing to a shipment:\n\n1. Create a draft order with basic shipment details\n2. Use \"Get Rates\" on the draft to see available courier options\n3. Update the draft with preferred courier selection\n4. Confirm the draft to create an actual order\n\n### Location Management\n\nSave frequently used addresses for faster order creation:\n\n1. Create locations with full contact and address details\n2. Use saved location IDs in orders instead of repeating address information\n3. Update or delete locations as needed\n\n## API Coverage\n\nThis node covers the main Biteship API endpoints:\n\n- ✅ Rates API (all location types: postal codes, coordinates, area IDs, mixed)\n- ✅ Orders API (create, retrieve, cancel)\n- ✅ Draft Orders API (full lifecycle management)\n- ✅ Tracking API (by order ID and waybill)\n- ✅ Couriers API (list available services)\n- ✅ Locations API (CRUD operations)\n- ✅ Maps API (area search)\n- ✅ Webhook support (through n8n webhook nodes)\n\n## Error Handling\n\nThe node includes proper error handling for common scenarios:\n\n- Invalid API keys\n- Missing required fields\n- Invalid location data\n- Courier service unavailability\n- Network timeouts\n\nError messages are descriptive and include suggestions for resolution.\n\n## Examples\n\n### E-commerce Order Fulfillment Workflow\n\n```\nTrigger (New Order) → \nBiteship (Get Rates) → \nSet (Select Best Rate) → \nBiteship (Create Order) → \nDatabase (Update Order Status) → \nEmail (Send Tracking Info)\n```\n\n### Shipment Tracking Automation\n\n```\nSchedule Trigger → \nDatabase (Get Pending Orders) → \nBiteship (Track by Order ID) → \nSwitch (Check Status) → \nEmail/SMS (Notify Customer) → \nDatabase (Update Status)\n```\n\n### Multi-Courier Rate Comparison\n\n```\nManual Trigger → \nBiteship (Get Rates) → \nCode (Parse & Compare) → \nGoogle Sheets (Log Results) → \nSlack (Send Summary)\n```\n\n## Best Practices\n\n1. **Use Test Environment**: Always test with test API keys before production\n2. **Rate Limiting**: Be mindful of API rate limits, especially in loops\n3. **Error Handling**: Implement proper error handling for network issues\n4. **Data Validation**: Validate address and item data before API calls\n5. **Webhook Integration**: Use n8n webhook nodes to handle Biteship webhooks for real-time updates\n\n## Supported Couriers\n\nBiteship integrates with major Indonesian courier services:\n\n- **Instant Delivery**: Grab, Gojek\n- **Same Day**: Grab Same Day, Gojek Same Day  \n- **Regular Services**: JNE, SiCepat, J&T Express, Pos Indonesia, Lion Parcel\n- **And many more regional couriers**\n\nEach courier has different service types (instant, same day, regular, express) with varying coverage areas and pricing.\n\n## Troubleshooting\n\n### Common Issues\n\n**Authentication Failed**\n- Verify API key is correct\n- Check if using correct environment (test/production)\n- Ensure API key has necessary permissions\n\n**No Rates Returned**\n- Verify origin/destination locations are valid\n- Check if courier services are available for the route\n- Ensure item dimensions and weight are realistic\n\n**Order Creation Failed**\n- Validate all required contact information\n- Check if courier service supports the route\n- Verify item details are complete and accurate\n\n**Tracking Not Working**\n- Confirm order ID or waybill ID is correct\n- Check if order has been confirmed and picked up\n- Some couriers may have delayed tracking updates\n\n### Getting Help\n\n1. Check the [Biteship API documentation](https://biteship.com/id/docs/api)\n2. Review error messages carefully - they often include specific guidance\n3. Test with smaller, simpler requests first\n4. Use test environment to avoid charges while debugging\n\n## Resources\n\n* [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)\n* [Biteship API documentation](https://biteship.com/id/docs/api)\n* [Biteship dashboard](https://biteship.com/dashboard)\n* [Biteship courier coverage](https://biteship.com/couriers)\n\n## Version History\n\n### 1.0.0\n- Initial release\n- Support for all major Biteship API endpoints\n- Declarative-style node implementation\n- Comprehensive error handling\n- Test and production environment support","readmeFilename":"README.md"}